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CYCLE 9 HELPFUL HINTS 


This paper describes helpful hints on how to use Cycle 9 of 
NOS/VE. It is intended to supplements rather than to replaces 
the standard NOS/VE docunentation. If you have any questions or 
suggestionss please see Tom McGee or Bonnie Swierzbin. Appendix 
DN tists background documerts and how to obtain them. 


To obtain additional copies of this document while running on 
$N191 at Arden Hills» pleese type? 


SESsINTI.LISTHINTS C=<number of copies> 


To obtain a copy with revision bars against the Helpful Hints 
of the previous builds one can type: 


SESaINTLLISTHINTS REVB C=<number of copies> 


The C parameter is optional and defaults to one. 


Undate History 

Date Changes 

12/22/8909 Revisions for NOS/VE Phase C 

2/12/81 Additional Revisions for NOS/VE Phase C€ 
6/097 81 Revisions for NOS/VE Bulld N 

6/19/81 Additional Revisions for NOS/VE Build 
8/28/81 Revisions for NOS/VE Build O 

11/06/81 Revisions for NOS/VE Build ? 

3/01/82 Revisions for NOS/VE Build 9 

4/15/82 Revisions for NOS/VE Cycle 2 

5/1/82 Revisions for NOS/VE Cycle 3 

6/3907 82 Revisions for NOS/VE Cycle 5 

7/297 82 Revisions for NOS/VE Cycle 7 

10/22/82 Revisions for NOS/VE Cycle 9 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


160 MAJDR_ CHARACTERISTICS OF THIS. BUILD 


o Cycle 6 and subsequent cycles of NOS/VE are built to run with 
a NOS 621 base system and the DSD disptays and commands have 
changed considerably from the NOS 5.3 base system used with 
Cycie 5. (See also the next bullet.) This hints document has 
been updated to reflect these changes where they affect 
NOS/VE»s for Instances using the command NVEnnnn to bring up 
NOS/VE instead of cpeNVEnnnn. For more information on the NOS 
commands see BJ Swierzbints memo of July 23 titled "NOS 6.1 
Notes!» the NOS refererce manuals listed In Appendix As or the 
NOS RO Software Release Bulletin. 


WARNING (1): NOS jots and subsystems may now be brought 
down by entering STOPs isnes for examples, STOPs,BID. willl bring 
down BATCHIO.w DQ NOTs DO NOTs BO NOT enter STOPsNVE. 


WARNING (2): SES R2C must be used with NOS V2 systems. 


The formats of the validations and user index files 
{usually named VALIDULZ and VALINDZ) have changed between NOS 
Version 1 and NOS Version 2. The modset which was added to 
the NOS 5€55 system ( the base for Cycle 7) changing the names 
of these files to NEWDUZ and NEWNDZ has oot been added to 5F40 
{the base for Cycle 9). This means that in order to run Cycie 
9 the site anatyst must make a copy of file NEWDUZ on “(file 
VALIDUZ and a copy of file File NEWNDZ on file VALINDZ. Ther 
when there is no tonger any need to run Cycte 7s NEWDUZ = and 
NEWNDZ can be pur gede 


9 9.l runs with NOS 5F41 and il Series networks, which Is the 
same level of networks that Cycle 7 runs withe 9e2 and 
subsequent systems run with NOS 5641 and 4 Series networks. 
The process for bringing up NAM and IAF has changed with the 
new level networks; see Section 4 for details. 


o Substantial changes have been made to the DS procedure in 
Cycle 9. See Section 4 for detalis. 


o Backup files created in Cycle 7 by the NOS/VE 
BACKUPLPERMANENT_FILE utility willlt) not be able to be used by 
the RESTORE _PERMANENT_FILE utility in Cycies 9 and 10. Alsos 
backup files created in Cycie 9 will not be able to he used by 
the RESTORE_PERMANENT_FILE utility in Cycle 10. 
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1.0 MAJOR 


CHARACTERISTICS OF THIS 8UILD 


o SCL Command List Changes 


Management of SCL command tists has changeds particularty 


as 


relates to asynchronous tasks. The changes were made 


primarily for performance and should have no impact on most 
(all) users. The chances are: 


An asynchronous task now has its own "job Level®™ command 
fist which is initialized to the “job tevei" command 
fist of its perent task. The asynchronous task may 
alter its command list without affecting its parent 
task. 


The system Supplied command library 
(osf$command_library) is now searched as part of the 
$system command list entry. 


Support for the following "oid" command names has been 
removed: 
ACCEPT,» CT,» CECLARE VARIABLE» DECVARs DO» INCLUDE> 
REMOVE _ VARTABLE and REMYAR 


Certain commands which previousiy were always found = at 
the front of the command tist have been moved to a tist 
which Is searched after all other command Ilist entries 
have been searched. (This fis to alfow a user to supply 
his/her own version.) The affected commands are? 
ACCEPT_LINEs ACCLs CREATE_VARIABLEs CREV» 
DELETE_VARIABLEs DELVs INCFs INCLUDE_FILE>s 
INCLs INCLUDE_LINEs SETCL and SET_COMMAND_LIST. 


The convention for function names (that their first 
character be a "#") has been made into a rute (i.e. a 
name that does not begin with a ™3" will not be 
recognized as a function name.) 


The PROCedure “append _command_tist™ no tonger exists. 
Its operation thas been replaced by a new parameter on 
the set command list commands namely “placement™ or “p® 
with possible values of "after", “a™, “before™s and "bh", 
with “before” as the default. This parameter affects 
whether command list entries being added are placed 
before or after the current entries in the list. 


The commands documented as being operator only commands 
are now actually avaliable only to the operator. 


The HCS commands are no longer supported. 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


- The full mode of the display _command_tist command has 
been upgraded $o that the commands on 
osf$command_ltibrery are displayed as part of the $system 
command list entry. Alsos the commands available on an 
object ftibrary which is a command fist entry are shown 
in the display. 


- The $file function now supports the cycle number (cn) 
options 


o QUICK DEADSTART does net work In Cycle 9. Use of this command 
will hang the system. 


o To access NOS/VE interactivelys the user must login to the 
application named VEIAF. For example: »sDAHsDAHX,VEIAF The 
previous application neme was TAF. 


o With Cycle 7s the operator of the NOS/VE duai state system can 
Simulate terminal breaks. Shefhe may Issue at any time a 
*BREAK at the K display for the NVE job. This wild start the 
terminal breaks which works just JIlke the interactive break. 
The broken command may be continued ody issuing the 
resume_command (resc) cr may be terminated by issuing the 
terminate_command (terc). If the command get_file is broken 
intos the command will be terminated by the Remote Host. 
After the DS proc has been executeds, a terminal break at the 
command level will cause the SCL task to terminate. The job 
monitor task will restart the SCL task after a brief delay (up 
to 20 seconds). 


o On 2 occasions» a procedure which {among other things) 
executed a TERMINATE_LOG crashed a Cycle 7 system. The PSR 
number for this problem is net available yet and the guilty 
oarty hasn't been Identifieds but It Is suggested that the 
user treat TERMINATE_LCG with a heaithy suspicion. 


o The user should not issue a pause or terminate break white 
DISPLAY_COMMAND_LIST is executing; this will CRASH the 
systeme 

o Known Remote Host probtems: 

The user name put or the banner for a job routed from the 
170 is incorrect. This has been reported with PSR NVODO73 and 
will be fixed in Cycle 9, 

o Miscetlaneous SCL Changes: 

A RING parameter has been added to the TASK/TASKEND 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


command. This parameter may be used to switch to a new ring 
of execution within the user's vyatidated minimum ring and 
nominal wring. 


A $RING function has been added. It has no arguments and 
returns the current ring of execution. 


Commands from user Jjobs are no longer written to the system 
fog by default. This function Is controlied by the new 
operator commands ACTIVATE_SYSTEM_LOGGING and 
DEACTIVATE_SYSTEM_LOGGING. 


The abbreviation for the SKIP_LTAPE command has been 
corrected to SKIT from SKIPT. 


A new internal interfaces CLPSVALIDATE_NAME has been 
added. This is an INLINE procedure that should be used 
Instead of the high overhead CLPSCONVERT_STRING_TO_LNAME. {See 
common deck CLXVN for interface details.) 


o DISPLAY FILE leaves the ‘source file with an attribute of 
RT=U. This can be corrected by setting the RT attribute back 
to the correct value after the DISPLAY vatue: SETFA file RT=V 


o COPY_LFILE will not copy at EGI if it had been specified on the 
COPF command. The following sequence will accomplish copying 
at EGI: 


SETFA dest_file OP=SEOTI 
COPF source_file dest_file 
SETFA dest_fite OPp=$801 


o The permanent file system has been modified to make files 
invisible when all cyctes have been purged even if one or more 
of those cycles are still attached. This results in 
references to the file emitting an unknown file message as 
expecteds rather than an unknown cycle message containing an 
invalid cycle number. It atso prevents disptay catalog 
commands from showing the file as having zero cycles. 


o The administer utility has been updated to correspond to Rev. 
9 of the NOS/VE Commend Interface ERS. 1d command == and 
parameter names are no longer supported. 


o The TAFNYVE operator command (TAF control point) is no longer 
required or available. The capabilities that were provided by 
it have been packaged within the NVE subsystem control pointe 
The impact of this change is as follows: 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


- The K display is assigned to the same control point 
during both deadstart and normal system operation. 


~ Output from the system core debugger will no longer 
appear at the NYE control point K-display. All system 
core debugger communication is via the MDD terminal. 


~ The K»*#BYEVE. command is no tlonger available. 


~ The OFFSWs jsns6. command before doing a STOPsisne iis 
not required to bring NYE down. 


- All capabilities are available via the  NVExxxx. 
command. The NVE subsystem may be placed at any contro} 
point (like NAM is). 


o Cycle 5 (actually Cycite 4) of NOS/VE no longer supports the 
"old" command names for system commands. Both “old” and "new" 
names have been supported since Bulid Q. See DAP ARH4S776 _ for 
details. As part of this change the abbreviations for the 
COPYLFILE and PRINT_LFILE commands have been corrected to COPF 
and PRIF (from COPYF. and PRINTF). 


o The EXPLAIN command was Implemented in Cycte 4 of NOS/VE. 
Don't get too excited about thiss however» because as yet 
there are no “explain level™ message templates for any of the 
system conditions. EXPLAIN will simply regurgitate the 
regular messages 


While implementing the EXPLAIN command it was discovered that 
the specification of the command (i.e. that it have an 
optional "condition" parameter) was not nearly as useful as 
having the first parameter be a “status” vatiue. So the 
implementation deviates from the ERS in that the first 
parameter to EXPLAIN is MESSAGE_STATUS or MS and is of kind 
STATUS. The $STATUS function can be used to transform a 
“condition” into a "status". <A DAP is being written to nake 
this change official. 


o NOS/VE multip!e mass storage volumes have been implemented in 
Cycle 5. For more information see the section ‘Configuration 
Management!. 


o The Interstate Communication Facilitys which Is described in 
Section 9 of the NOS/VE ERS ~- Program Interface {Reve. 98)» has 
been implemented. The callable subroutines described in 
section 9.3 reside In User Library LINKLIB In the Integration 
catalogs INTl»s ODEV1l» RELl»s etc. NOS tibraries SYSLIB and 
SRVLIB are also required to complete the loading process. 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


LDOSET loader commands must be used to select these IJlibraries. 
Interactive Usage Restrictions: | 


-~ When logging In to NOS/VE (i.e. HELLOsVEIAF etc.) do not 
enter a terminate treak (CTRL t) or a pause break (CTRL p) 
before the 'welcome message* appears at the terminal. A 
pause or terminate break entered before the interactive 
NOS/VE job has completed it's initialization may crash the 
system. ; 


~ A REQUEST TERMINAL command in a batch job no longer crashes 
the system. 


Any product or utility that is placed In the 3SYSTEM catalog 
{or any frequentiy loaded program) should be bound using the 
CREATE_MODULE subcomnand of the CREATE _OBJECT_LIBRARY 
utility. This will minimize overhead associated with loading 
the product or utility. 


Debug responds to terminal breaks when a program is being 
debugged. However,» entering a pause or terminate break when 
debug is active (i.e. the DB/ prompt has appeared and the 
user has not Issued the RUN command) will cause the task to 
terminate. 


When sharing executable files via permanent files (i.22@>s 
compilers, tlibrariess, etc.) you should make the file an 
object tibrary via the CREATE_LOBJECT_LIBRARY utility. By 
sharing object libraries Instead of object files» the code Is 
actually shared among all tasks using the library; the tibrary 
Is not copied to another segment but Is executed directly. 


1.1 NOS/VE_USAGE_ EXAMPLES 


1le1.e1 EXECUTING PROGRAMS 


PROCESS 


Create an object text file by compiling a program on NOS. 


Then perform the following steps on NOS/ VE: 


Acquire any necessary Jibraries (which are not auoted in text 
embedded directives) by either: 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
1elel EXECUTING PROGRAMS 


o Attaching them from the system catalogs either explicitiy 
or via prolog 
or 
o Creating the library file via the object library generator 


ofr 
o Staging the Jtibrary file from NOS to NOS/VE using the 
GET_OBJECT_LIBRARY command. 


~ Get the flle from NOS end convert the object text file from 
the CI data mapping to II data mapping by executing the 
CONVERTLOBJECTLFILE command. 


~- Load and execute the program via the EXECUTE_TASK commands 
specifying the necessary iibraries with the LIBRARY parameter 3 
aiternatively SETLPROGRAM_LATTRIBUTES may be used to include 
the libraries in all subsequent EXECUTE_TASK commands. 


~ Stage the tloadmap frem NOS/VE to NOS for printing by using 
either: 


o The REPLACE_FILE command with A6é conversion mode specified 
Gf running on the simulator. 
or 
o The PRINT FILE command if running on the hardware. 


EXAMPLES 


The following is an example command sequence for executing a 
program not requiring any Itibrarles for loading: 


Assumptions: alt modules to be loaded are contained on the NOS 
permanent file *citxtrs?. 


CONVERT_OBJECT_LFILE CITXTRS 
EXECUTE TASK CITXTRS PARAMETER=' program parameters! 
PRINT UFILE LOADMAP 


The following is an example command sequence for executing a 
program requiring libraries for toading: 


Assumptions: the NOS permanent file tcitxtrs! contains object 
text generated by the CYBIL CI compiler. The compiter modules 
reference procedures cortained on the Jibrary ‘mylib'® and the 
CYBIL run<-time {ttbrary. These ttibraries have been generated on 
NOS/VE and saved on NOS. 


GET_LOBJECT_LIBRARY MYLI8 
SETLPROGRAM_LATTRIBUTES LOADLMAP_OPTIONS= (BLOCK sENTRY_POINT » SEGMENT 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
1.1.1 EXECUTING PROGRAMS 


CONVERTLOBJECTLFILE CITXTRS 
EXECUTE_LTASK CITXTRS "program parameters! LIBRARY=MYLIB 
PRINT_FILE LOADMAP 


1lel.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


Notes: 


o CLGO1L7G is NCS permanert file name for file containing CI 
object text for modules to be Included in the tibrary. 


o IITEXT180 is NOS/VE iocal file name for fiie containing II 
object text for modules to be Included in the library. 


0 LIBRARY180 Is NOS/VE Iccail file name for the library being 
created. 


o IL1I8170 is NQS permanent file name for file containing the 
library. 


NOS/VE Job Commands 
CONVERT_LOBJECT_FILE IITEXT180 CLGD170 
CREATE_DBJECT_LIBRARY 
ADD MODULE LIBRARY=IITEXT180 
GENERATE_LIBRARY LIBRARY=LIBRARY180 


Quit 
REPLACE_FILE LIBRARY180 IL18170 DC=B56 


1.1.3 MODIFY A PREVIOUSLY SAVED QBJECT LIBRARY 


Notes: 


o ILI8170 Is NOS permanent file name for file containing the old 
fibrary 


o LIBRARY180 is NOS/VE local file name for file containing the 
old tibrary 


o €M0D170 Is NOS permanent file name for file containing CI 
object text for the new module 


| Oo NEWIIMODULE is NOS/VE tocal file name for file containing II 
object text for the new module 
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1.1.3 MODIFY A PREVIGUSLY SAVED OBJECT LIBRARY 


© NEWLIBRARY is NOS/VE !ccal file name for the tibrary being 
created 


o NLIB170 is NOS tocal file name for new tibrary 
NOS/VE Job Commands 


GETLOBJECTLLIBRARY LIBRARY180 ILIB170 
CONVERTLOBJECTLFILE NEWIIT MODULE CMOD170 
CREATE_OBJECT_LIBRARY 

ADD MODULE LIBRARY=LIBRARY180 
REPLACE_MODULE LIBRARY=NEWIIMODULE 
GENERATE_LIBRARY LIBRARY=NEWLIBRARY 
QUIT 

REPLACELFILE NEWLIBRARY NLIBI7C0 DC=B56 


1.1.24 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


Running from an interactive terminals enter: 


GETsfilename. 
ROUTEs filename »DC=LP »FC=REH. 


The input file which Is sent to NOS/VE must be in 6/12 ASCII 
(or display code subset). The job file must be aie single 
partition NOS record ccntaining NOS/VE commands. The first 
statement must be a valid LOGIN command with users password and 
family name specified. Multi oartition input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET_LFILE command. 


1ele5 PRINT A NOS/VE FILE 


At NOS/VE job termination the Job tog will be automatically 
returned to NOS. The job tog will be appended to the NOS/VE 
output file OUTPUT. NOS/VE print files must be written by BAM as 
8/8 ASCII RT=V. Print files will be converted from 8/8 ASCII 
RT=V to NOS 8/12 ASCII when they are sent to NOS and will = be 
printed in upper/lower case. 


Aft NOS/VE output files will appear iIn the NOS output queue 
(NOS QsPR display) with the name NVExxxx as a banner. In order 
to print a NOS/VE files the following command must be issued 
within your job or be entered from the system console via the 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
1.1.5 PRINT A NOS/VE FILE 


operator facility: 


PRINT_LFILE filenawe 
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200 COMMAND INTERFACE STATUS 


2e1 ACCESS _TO_NOSZVE_IN_DUAL_ STATE 


2e1.1 LOGIN TO NOS/VE 


To initially togin to NOS/VE via VEIAF»s you must cause the 
first login attempt to fail. This can be done by responding to 
the “"FAMILY:" ftogin prompt with something Like: "ses". This must 
be done because the system will try to connect the terminal to 
IAF on the (first togir attempt no matter what is typed. Te 
access VEIAF do the following on the second "FAMILY?" prompt: 


2» US @Trspasswor ds VETAF 


You can access VEIAF from IAF by doing “HELLO»VEIAF™ or by 
answering VEIAF to the system prompt "APPLICATION: *™. 


2ele2 TERMINAL USAGE 


1) The slant (/) Is the prompt to enter a NGS/VE command. Any 
normal NOS/VE commard can now be entered (continuation 
fines are prompted with ee+/)+ The full ASCII character 
sets lower or upper case and all special characters» can be 
us@de 


2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be 
started by responding to the 'APPLICATION:* prompt with 
VEIAF. 


3) Terminal breaks (control-t and control-p) can be used to 
terminate a task or command and suspend a task and enter a 
new task to process SCL commands. Control-t causes 4 
terminate break and controft-p causes a pause break. 
Terminate break will terminate a command or the most 
recently executed task. A pause break will suspend 
execution and ailow commands to be entered. When a 
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201 


e2 TERMINAL USAGE 


terminal is In pause break states two additional commands 
are avaitablie:s 


RESUME_COMMAND - resume execution at the point of 
interruption. 


TERMINATE_COMMAND - cause a terminate break condition as 
a terminate break had heen entered, 


Both terminate break ard pause break are available to programs 
as conditions via the program management condition mechanism. 


201-23 NOS/VE PROGRAM ACCESS TQ THE TERMINAL 


1) Interactive NOS/VE jobs are able to obtain terminal input 
through the AMP SGET_NEXT or AMPSGET PARTIAL program 
interface which can be used by both task services and user 
ring programs. Interactive programs which use this 
interface should be able to handie both upper and tower 
case Input in order to make them more convenient to use in 
both 64 and 96 character set modes. 


202 COMMAND. AND. PARAMETER NAMES 


During the next few months a command supported by the system 
may not be in syne with your command interface document. The 
parameter descriptor tabie gives an accurate, concise description 
of the command interface as currentiy supported. 


POT 8eader's Guide 


The definition of a conmand's parameter fist is enclosed in 
parenthesis with a perameter description per Iline. Fach 
description has the general form: 


PARAMETER NAMES ALLOWED PARAMETER VALUES = PARAMETER DEFAULT 
VALUE 


Parameter Names - describes the parameter name and any 
abbreviations. 


ALLOWED PARAMETER VALUES =- describes the kind of value allowed 
and whether a fist of values Is possible. The value kind can be 
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202 COMMAND AND PARAMETER NAMES 


further qualified. In some casess the actual values allowed are 
described using the KEY notation. The vatue kinds include 
INTEGER», STRINGs NAMEs FILEs STATUS. 


PARAMETER DEFAULT VALUES - describes the defauiting rules 
and/or values for the parameter. $REOQUTRED and S$0PTIONAL are 
obvious. Other values In this position will be treated as if 
they were entered by the user on command invocation. 


See the PROC command in the Command Interface ERS for more 
detalis. 


The PDTs for the commards currently in the system can be 


dispiayed using the DISPLAY _COMMAND_INFORMATION command. This is 
documented In the nonstandard command section of this document. 


2e3 COMMAND EUNCTIONS 


Eupction itftatus 

$M 0D unchanged 
SC HAR unchanged 
$CLOCK unchanged 
$DATE unchanged 
$F ILE unchanged 
$FNAME unchanged 
SINTEGER unchanged 
$NAME unchanged 
$ORD unchanged 
SREAL unchanged 
$STRING unchanged 
$STRLEN unchanged 
SS TRREP unchanged 
$SUBSTR unchanged 
$UNI QUE unchanged 
$TIME unchanged 
SV AR unchanged 
SSPECIFIED unchanged 
$SET_COUNT unchanged 
$VALUE_COUNT unchanged 
$RANGE unchanged 
S$PARAMETER_LIST unchanged 
$PARAMETER unchanged 
$STATUS unchanged 
CONDITION unchanged 
$SEVERITY unchanged 
$PROCESSOR unchanged 
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2.3 


com 


ed 


¥*} 


$J 08 unchanged 
$P ROGRAM unchanged 
$R ING new 
, SYSTEM ACCESS _ COMMANDS 
Compands siatus 
SETLLINK_ ATTRIBUTES unchanged 
LOGIN unchanged - *1 
LOGOUT unchanged 
SETUPASSWORD unchanged 
The family name of the job doing the submit will be used as 
the default famiiy name on batch jobs. The default for jobs 
submitted from NOS will be family SSYSTEM. This effectively 
means that whenever NCS/VE jobs are submitted from NOS the 
family parameter is required. 
RESOURCE MANAGEMENT 
Command atatus 
REQUEST_UTERMINAL unchanged 
ELLE MANAGEMENT 
Command aftatus 
SETLFILE_ATTRIBUTES unchanged 
COPY_FILE unchanged 
DISPLAY FILE unchanged 
COMPARE_FILE unchanged 
DISPLAY_FILE_LATTRIBUTES unchanged 
SKIPLUTAPE unchanged 
PERBMANENT_FILE_ MANAGE MENT 
Command | atatus 
GETLFILE unchanged 
REPLACE_FILE unchanged 
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CREATE_FILE unchanged 
ATTACH_LFILE unchanged 
DELETELFILE unchanged 
CHANGE_CATALOG_LENTRY unchanged 
CREATE_FILE_PERMIT unchanged 
DELETE_FILE_ PERMIT unchanged 
CREATE CATALOG unchanged 
DELETE_CATALOG unchanged 
DELETE_CATALOG PERMIT unchanged 
CREATE LPERMIT_CATALOG unchanged 
DISPLAY CATALOG. unchanged 
DISPLAY _CATALOG_ENTRY unchanged 
SET_WORKING_CATALOG unchanged 
268 SCL. STATEMENTS AND _PRCCEDURES 

Command status 

PROC/PROCEND unchanged 
SET. COMMAND LIST unchanged 
DISPLAY_COMMAND_LIST unchanged 
REPEAT/UNTIL | unchanged 
WHILE/WHILEND unchanged 
CREATE VARIABLE unchanged 
DELETE VARIABLE unchanged 
BLOCK/BLOCKEND unchanged 
LOOP/LOOPEND unchanged 
FOR/FOREND unchanged 
IF/ELSEIF/ELSE/IFEND unchanged 
CYCLE unchanged 
EXIT unchanged 
WHEN/WHENEND unchanged 
CONTINUE unchanged 
CANCEL unchanged 
INCLUDE_FILE unchanged 
COLLECT _TEXT unchanged 
DISPLAY VALUE unchanged 
EXIT PROC unchanged 
ACCEPT_LINE unchanged 
INCLUDE _LINE unchanged 
CREATE _FILE_CONNECTION unchanged 
DELETE_FILE_CONNECTIOR unchanged 
DISPLAY FILE CONNECTION unchanged 
change HCS variable unchanged 
display HCS variable unchanged 
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2-9 INTERACTIVE COMMANDS 


*1 


Command 


RESUME COMMAND 

TERMINATE COMMAND 

SET. TERMINAL_ATTRIBUTES 
DISPLAY_TERMINAL_ATTRIBUTES 
esc-a 

esc~l 

esc- j 

esc~t 

esc7x 


These commands are 


entered 


afatus 


unchanged 
unchanged 
unchanged 
unchanged 
new ~ 1* 
new - 1* 
new - 1* 
new ~- 1* 
new - 1* 


with the 


escape keys characters carrlage_-returne The 


the following meanings: 


eM ctu. — D 


2010 GBLECT CODE _MAINTENARCE 


Command 


CREATE_ODBJECT_LLIBRARY 
DISPLAY_NEW_LIBRARY 

SELECT _DISPLAY_OPTION 

ADDL MODULE 

REPLACE _ MODULE 
COMBINE _ MODULE 
CREATE_MODULE 

BIND MODULE 
CREATE_PROGRAM_DESCRIPTION 
DELETE MODULE 
CHANGE_MODULE_ATTRIBUTE 
SATISFY_LEXTERNAL_REFERENCES 
REORDER MODULE 
GENERATE_LIBRARY 
DISPLAY_OBJECT_LIBRARY 
COMPARE_OBJECT_LIBRAR Y 
QUIT 

CI to II Conversion 


perform "disolay_ job status” command 
perform "display_iog 10” command 

perform "displey job _status af1" command 
discard atl unrrocessed,s 
terminate jobs but do not disconnect 


status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


3—key sequence? 
characters have 


typed-ahead input 
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2e11 USER SERVICES 


@ell USER_SERVICES 


Command  S§katus 
DISPLAY_LOG . unchanged 
DISPLAY _ MESSAGE unchanged 


2el2 EILE ROUTING 
Commaod Status 
HCS JMROUTE removed 


2013 PROGRAM_EXECUTION 


Command atatus 

SET -PROGRAM_ATTRIBUTES unchanged 
DISPLAY_PROGRAM unchanged 
EXECUTE unchanged 
"name cali” unchanged - *] 
TASK /TASKEND unchanged 
TERMINATE_TASK unchanged 

WAIT unchanged 

SET _DEBUG_RING unchanged 
DISPLAY_ACTIVE_TASKS unchanged 


*1 Warning ~ "name call" works onty for SCL procedures unless a 
SETFA command has teen issued to specify that the 
FILE_CONTENTS are OBJECT and the FILE_LORGANIZATION is OATA or 
LIBRARY. The SETFA cecmmand must be reissued every time the 
file is brought over from NOS. The CONVERTLOBJECT_FILE>» 
GETLOBJECTLFILEs and GET_LOBJECT_LIBRARY nonstandard commands 
Issue the appropriate SET_LFILE_ATTRIBSUTES command and are 
therefore recommended. 


2014 J08_ MANAGEMENT 


Comnaodg status 

SUBMIT_J0B unchanged 
DISPLAY_JOB_STATUS unchanged 
TERMINATE, JOB unchanged 
PRINT FILE unchanged 
TERMINATE_PRINT unchanged 
DISPLAY_PRINT_STATUS unchanged 
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2015 NON_STANDARD COMMANDS 


The following commends provide a nonstandard means of 
performing various frequertly performed functions. They may be 
superceded in subsequent builds by standard commends = = and 
capabilities. 


2e15e1 DELETE_LCATALNG_CONTENTS 3 DELCC 


The purpose of this command is to delete all entries from the 
specified catalog. This includes subcatalogs and the files they 
contain. 


defete_ catalog contents [catalog=<catalog>] 
Cstatus=<status variabie>] 


catalogic: This parameter specifies from which catalog all 
files are to be deleted. BDmission wilil cause 
the current working catalog to be used. 


status: See ERROR HANDLING. 
2el5e2 DISPLAY_ACTIVE_TASK 3 DISAT 


The purpose of this ccmmand Is to display task statistics for 
alt currently active tasks in a job. The following information 
is displayed. 


task name 
execution time use 
number of page faults 


dtselayeserlve. task Coutp ut=<file>) 
Cstatus=<status varlablte>] 


outputio: This parameter specifies the file to which § the 


task statistics ts displayed. Omission will 
cause $OUTPUT to be used. 
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201563 DISPLAY_SYSTEMLDATA 3 DISSD 


The purpose of this command is to display system page fault 
statistics and system monitor request statistics. 


display _system_data [display_option=page_faultsi pf 
imonitor requestsimriall 
Cdisplay_formatz=incrementalilitotalit] 
Coutp ut=<file>] 
Cstatus=<status variable>d!} 


display option do: This parameter specifies which 
statistics are to be displayed. The 
following options are allowed :;: 


Fage faults ~ display the page 
fault statistics. 


monitor requests - display the system 
monitor request 
statistics. 


{mission will cause ALL to be 
usede 
display formats df: This parameter specifies whether a 


cIisplay of the ali statistics recorded 
so far (total) or only these statistics 
recorded since the fast 
display_system_data command 
(incr emental) should be displayed. 
Cmission will cause incremental to be 


uSede 
outputio: This parameter specifles the file to 
which the system data will be 


cisplayed. Omission will cause $OUTPUT 
to be used. 
status: See ERROR HANDLING. 
201504 DISPLAY_JOB_LDATA : DISJO 


The purpose of this command is to display the following job 
related statistics: 
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time In Job mode 

time in monitor mode 

count of page in operations 
reclaimed pages 

new pages assigned 

working set size 

count of ready tasks 


display job data [display _option=job_datal 
Cdisplay_formatzincrementaliiitotal:t] 
Coutput=<fille>) 
{status=<status variabie>] 


display_optionido: This parameter specifies which 
statistics are to be displayed. The 
following options are allowed: 


Job .data - display job related data. 


Cmission will cause job data to be 
used. 


display_formati df: This parameter specifies whether a 
cisplay of the ali statistics recorded 
so far (total) or only these statistics 
recorded since the last display job_data 
command (incremental) should be 
displayed. Omission will cause 
incremental to be used. 


output; o: This parameter specifies the file to 
which the job data will be displayed. 
Cmission will cause $DUTPUT to be used. 


status: See ERROR HANDLING, 
221525 DISPLAY_COMMAND_INFORMATION ? DISCI 


The purpose of this command is to display current Information 
about a NOS/VE command. The parameter names» abbreviations» 
allowed values and known problems for a commands as supported in 
the current systems can be determined. This is a nonstandard 
command and wit! be replaced by the heip utility sometime in the 
future. 


display command information command _name=<namedi al | 
Cutility_namezcreate_object_Jibrary: 
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colisource code_utilityiscuisystem) 
idisplay. option=parameter description_table} 
pdtinotesinamesthelp] 
Coutput=<file referenced] 
Cstatus=<status varlable>] 


command nameicn: This parameter specifies the name of the 
command about which information is to be 
displayed. 


utility vnameiun: This parameter specifies which utitity the 
command betongs toe Omission wild cause 
SYSTEM to be used. 


display_optionido: This parameter specifies the type of 
display being requested. The options are: 


parameter_description_tableipdt - selects 
a dispiay of the parameter descrip- 
tion table used by the command when 
executed. 


notes - selects a dispiay of any known 
problems with the command. 


names - selects a display of the command 
names for 2 utility. 


help - selects a display of the command 
interface description of the command. 


Omission will cause PDT to be used. 

outputio: This parameter specifies the file to which 
information will be displayed. Gmission 
wilt cause $OUTPUT to be used. 


status: See ERROR HANDLING. 
221526 CONVERT_LOBJECTLFILE $ CONOF 


The purpose of this command is to get a NOS/VE object file 
produced on NOS and to convert it to an object file suitabie for 
processing by the NOS/VE toader or object code maintenance 
commands « 


convert_object_fite toz<file referenced 
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{from=<name>] 
fuser =<name> ] 
{status=<status varliable>] 


toit: This parameter specifies the NOS/VE file name on 
which the converted object file is to be written. 


fromif: This parameter specifies the name of the NOS file to 
be converted. This is the permanent file name as 
defined In the NOS file system and can be up to seven 
characters In tength. 


Omission will cause the permanent file name of the 
TO parameter to be used, 


useriu: This parameter specifies the NODS user identification 
of the owner of the file. This parameter is only 
neccessary if the file is in a catalog other than the 
user who was specified by the most recently issued 
SETLLINK_ATTRIBUTES command. 


Status: See ERROR HANDLING. 
221527 GET_OBJECTLFILE +: GETOF 


The purpose of this command is to get a oreviously converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that wil! allow the object file to be used by 
NOS/VE. 


get_obJjJect_file to=<file reference> 
Cfrom=<nare>] 
Cuser=<Cname>] 
{status=<status variable>] 


to:t: This parameter specifies the NOS/VE file name of the 
object file. 
fromif: This parameter specifies the NOS file name of the 
object file. This is the permanent file name as 
defined in NOS and can be up to seven characters in 
fength. 


Omission wil! cause the permanent file name of the 
TO garameter to be used. 


userju: This parameter specifies the NOS user identification 
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of the owner cof the file. This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified by the most recentiy issued 
SETLLINK_ATTRIBUTES command. 


status: See ERROR HANCLING. 
2021528 GET_LOBJECT_LIBRARY { GETOL 


The purpose of this command is to get a previously created 
NOS/VE object tibrary from the NOS side and set the appropriate 
file attributes that will allow the object library to be used on 
NOS/VE. 


get_object_library to=<file referenced 
{Cfrom=<name>]. 
Cuser=<name>] 
Cfstatuse<status variable>] 


toit: This parameter specifies the NOS/VE file name of the 
object library. 


fromif: This parameter specifies the NOS file name of the 


object file. This Is the permanent file name as 
defined in NOS and can be up to seven characters In 
length. 


Dmission will cause the permanent file name of the 
TO parameter to be used. 


useriu: This parameter specifies the NOS user identification 
of the owner of the file. This parameter Is only 
necessary if the file is in a catalog other than the 
user who was specified on the most recently issued 
SETLLINK_ATTRIBUTES command. 


status: See ERROR HANCLING. 
2015-9 DISPLAY_ODBJECT_LTEXT $ BISOT 


The purpose of this command is to produce a formatted display 
of the object text contained in an object file or object fibrary 
produced on NOS/VE. 
display_object_text file=<file> 
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foutput=<file reference>] 
(status=<status variable>d] 


file!f: This parameter specifies the object File or object 
tlbrary containing the object text to be listed. 


out putio: This parameter specifies the file to which the 
display is to be written. 


Omission will cause the file f0UTPUT to be used. 


status: See ERROR HANDLING. 
2015210 GET_SODURCE_LIBRARY $ GETSL 


The purpose of this conmand is to get a previously created SCU 
source library from the NCS side and set the appropriate file 
attributes that will atlow the source IJlibrary to be used on 
NOS/VE. 


get source library toxz<file reference> 
{Cfrom=<name>d] 
Cuser=<name>] 
{Cstatus=<status varlabie>] 


toit: This parameter specifies the NOS/VE file name of the 
source llbrar ys 


fromif: This parameter specifies the NOS file name of the 
source {ibrary.e This ts the permanent file name as 
defined in NOS and can be up to seven cheracters in 
length. 


Omission will cause the permanent file name of the 
TO parameter to be used. 


userius This parameter specifies the NOS user identification 
of the owner of the file. This parameter Is only 
necessary if the file Is In a catalog other than the 
user who was specified on the most recently Issued 
SETLLINK_ATTRIBUTES command. 


status: See ERROR HANDLING. 
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2015011 EDITIFILE + EDIF 


2015211 EDITLFILE } EDIF 
The purpose of EDIT FILE is to initiate the execution of the 
SCU editor on a text file. (For details see ARH3883.) 


edit.file i edif - edit jiines on a source file. (procedure file 
not necessarily In its final form) 


parameters defaults 
file=file(scource) $REQUIRED 
Cresult=fite (source) ] $VALUE(FILE) 
Cinput=file reference ]j $COMMAND 
Loutputzfile reference] $OUTPUT 
{status] 


2015212 JEDIT 


The purpose of this command is to initiate execution of the 
JEDIT editor built by Jack Bohnhoff. Anyone wanting information 
about the editor should contact Jacks 


jedit from=<file> 
Cstatus=<status var liabie>] 


fromif: This parameter specifies the file to be edited. 
This file is rewritten after the editor 
terminates. 


status: See ERROR HANDLING in the NOS/VE Command 
Inter face. 


2015.13 DEBUG 


The prototype R1 NOS/VE debugger is now available. Details on 
how to use the debugger can be found in the "CYBER 180 
INTERACTIVE DEBUG External Reference Specification and User's 
Guide™,» Sunnyvale DOCS number $4028. 
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2015214 SETLLINK_LATTRIBUTES 3 SETLA 


The SETLLINK_LATTRIBUTES command is the same as documented in 
the NOS/VE command interface with the exception that the CHARGE 
and PROJECT parameters are optional Cand in fact not useful In 
the current environment since we disable that feature on the NOS 
side). 
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3.0 PROGRAM INTERFACE STATUS 


3.0 PROGRAM INTERFACE STAIUS 


The 'status' column indicates 
unchanged from the previous bullds» 
bulid or not available in this build. 


within each section. 


whether 
modified 


3e1 COMMAND PROCESSING 

Peocedure status 

CLPSSCAN_PARAM_LIST unchanged 
CLPSTEST_PARAMETER unchanged 
CLPSGET_KEYWORD unchanged 
CLPSGET_LSET_COUNT unchanged 
CLPSGET_VALUE_COUNT unchanged 
CLPSTEST_RANGE unchanged 
CLPSGET_VALUE unchanged 
CLPSCREATE_VARIABLE unchanged 
CLPSDELETE_VARIABLE unchanged 
CLPSREAD_VARIABLE unchanged 
CLPSWRITE_VARIABLE unchanged 
CLPSSCAN_COMMAND_FILE unchanged 
CLPSENDUSCAN COMMAND. FILE unchanged 
CLPSSCAN_COMMAND_LINE unchanged 
CLPSCREATE_FILE_ CONNECTION unchanged 
CLPSDELETE_FILE_CONNECTION unchanged 
CLPSPUSH/POP_LUTILITY unchanged 
CLPSGET_COMMAND_ORIGIN unchanged 
CLPSGET_DATA_LINE unchanged 
CLPSSCAN_PROC_DECLARATION unchanged 

342 MESSAGE. GENERATOR 

Procedure atatus 

OS PSFORMAT_MESSAGE unchanged 
OSPSSETLSTATUS_ABNORMAL unchanged 
OS PSAPPEND_STATUS_PAR AMETER unchanged 
OSPSAPPEND_STATUS_INTEGER unchanged 
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3.0 PROGRAM INTERFACE STATUS 
30 23 RESOURCE | MANAGE MENT 


PO RD PORE mam 


3e3 RESOURCE MANAGEMENT 


RMPSREQUEST_LTERMINAL call 


304 


Procedure 


RMPSREQUEST_UMASS STORAGE 
RMPSREQUEST_TERMINAL 


All terminal attributes can be specified on the 
but only the following are operational: 


auto linput 
transparent_mode 
prompt _file 
prompt uistring 


o°o 6 0 


status 


unchanged 
unchanged 


PO PO DO PEPE PO PR PED PE HO PD DADE PE PE PD PAPE OAD 88 BE PO OE O88 HEE PEPE PE PE PE PD PAPE PED PO PE OPE EMT ANN 


Files assigned to a terminal device can be accessed via the 
foltowing BAM requests: 


AMPSOPEN 
AMPSGET_NEXT 
AMPSGET_DIRECT 
AMPSGET_PARTIAL 
AMPSPUT NE XT 
AMPSPUT_DIRECT 
AMPSPUT_PARTIAL 
AMPSCLOSE 
AMPSREWIND 
AMPSSKIP 
AMPSSEEK_DIRECT 


eo0oo 00 e800 © 


PROGRAM_EXECUTION 
Proceducse 


PMPSEXIT 

PMPSEXECUTE 

PMPSTERMINATE 
PMPSAWAITLUTASK_TERMINATION 
PMPSMDNDULE_TABLE_ADDRESS 
PMPSENTRY_POINT_TABLE_ADDRESS 
PMPSPUSH UTASK_DE BUG MODE 
PMPSSETLTASK_DEBUG_MOCE 
PMPSTASK DEBUG _MGDE_ON 
PMPSSET_DEBUG_RING 
PMPSDEBUG_RING 
PMPSCHANGE_DEBUG _LIBRARY_LIST 
PMPSPOP_TASK DEBUG _MOCE 


status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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305 PROGRAM COMMUNICATION 


306 


Procedure 


DSPSAWATTLACTIVITY_COMPLETION 
PMPSDEFINE_QUEUE 
PMPSREMOVE_QUEUE 

PMPSCONNECT_ QUEUE 
PMPSDISCONNECT_QUEUE 
PMPSSEND_UTO_QUEUE 
PMPSRECEIVE_FROM_QUEUE 
PMPSSTATUS_QUEUE 
PMPSSTATUS QUEUES _DEF INED 
PMPSGET_QUEUE_LIMITS 


CONDITION PROCESSING 
Procedure 
PMPSESTABLISH_CONDITICN HANDLER 


PMPSDISESTABLISH_COND HANDLER 
PMPSCAUSE_CONDITION 
PMPSCONTINUE_TO_CAUSE 

PMPSTESTLO CONDITION_ HANDLER 
PMPSVALIDATEL PREVIOUS_ SAVE AREA 
PMPSESTABLISH_DE8UG_OFF 
OSP$SETLSTATUS_LFROM_CONDITION 


PROGRAM_SERVICES 
Procedure 


PMPSGENERATE_UNIQUE_NAME 
PMPSGET_TIME 
PMPSGET_MICROSECOGND_CLOCK 
PMPSGET_ TASK _CP_TIME 
PMPSGET_DATE 
PMPSGET_LUSER_LIDENTIFICATON 
PMPSGET_ACCOUNT_PROJECT 
PMPSGET_JOBLNAMES 
PMPSGET_JOB_ID 
PMPSGET_JOBLMODE 

PMPSGET_ PROGRAM 
PMPSGET_TASK_ID 
PMPSMANAGE _SENSE_ SWITCHES 
PMPSGET_LOS_VERSTION 


status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


status 


PO AS PO PE BO PE REDD PO PO PE 28 PE OE OE HO PO AE REPS TO Ea ee 0 90 nae cane bene pene vane neon net ten i ee id 


Added support of detected 
uncorrected error 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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327 PROGRAM SERVICES 


308 


329 


PMPSGET_PROCESSOR_LATTRIBUTES 
PMPSDEFINE_DEBUG_LENTRY 
PMPSGET_DEBUG_ENTRY 
PMPSMODIFY_DEBUG_LENTRY 
PMPSREMOVE_DEBUG_LENTRY 


LOSGING 
Procedure 


PMPSLOG 
PMPSLOG_LASCII 


EILE MANAGEMENT 
Procedure 


Sequential Access 
Byte_Addressable Access 
Record Access 

Segment Access 

ViSystem Specified 
V_User Specified 
U_System Specified 
U_User Specified 

F_ System Specified 
FLUser Specified 
AMPSDESCRIBE_NEW_FILE 
AMPSFILE 
AMPSGET_FILE_ATTRIBUTES 
AMPSFETCH 

AMPSSTORE 

AMPSCOPY_FILE 
AMP3RENAME 
AMPSRETURN_FILE 
AMPSOPEN 

AMPSCLOSE 
AMPSFETCH_ACCESS_INFORMATION 
AMPSSKIP 

AMPSREWIND 
AMPSWRITE_LEND_PARTITICN 
AMPSGET_ NEXT 
AMPSGET_DIRECT 

AMPSGET_ PARTIAL 
AMPSPUT_NEXT 
AMPSPUT_DIRECT 
AMPSPUT_PARTIAL 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


Status 


unchanged 
unchanged 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
deleted 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
new name 
unchanged 
unchanged 
unchanged 
unchanged 
*2 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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*1 


unchanged - *3 
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309 FILE MANAGEMENT 


#1 


¥*2 


*3 


AMPSSEEK_DIRECT unchanged 
AMPSGET_ SEGMENT _ POINTER unchanged 
AMPSSET USEGMENT_LEOQIL. unchanged 
AMPSSET USEGMENT. POSITION unchanged 
AMPSSET_LLOCAL_NAME_ ABNORMAL unchanged 
AMPSSETLUFILE_INSTANCE ABNORMAL unchanged 
AMPSACCESS_METHOD unchanged 
AMPSFETCH_UFAP_LPOINTER unchanged 
AMPSSTORE_FAP_POINTER unchanged 


Segment access If a segment access file is written and an 
AMPSSETLSEGMENT_LEODI is not issued to record the EQGI, EDI 
remains zero. The highest page referenced is not yet used as 
the default EDI. This particularty affects those who wish to 
make heaps permanent because EDI Is always zero for a heap. 


AMPSREWIND The WAIT parameter on the procedure cail is not 
Supported. 


AMPSPUT_PARTIAL PUT_PARTIAL with the TERM_OPTION = 
AMCSTERMINATE does not act as a put _next If a preceding START 
was not issued. 


3010 PERMANENT FILE MANAGEMENT 


Procedure atatus 

PFPSDEFINE unchanged 
PFPSATTACH unchanged 
PFPSPURGE unchanged 
PF PSCHANGE unchanged 
PFPSPERMIT unchanged 
PFPSDELETE_PERMIT unchanged 
PFPSDEFINE_ CATALOG unchanged 
PF PSPURGE_CATALOG unchanged 
PFPSPERMIT_ CATALOG unchanged 
PFPSDELETE_CATALOG_ PERMIT unchanged 


3211 MEMORY MANAGEMENT 


MMPSADVISE_IN unchanged 
MMPSADVISE_ OUT unchanged 
MMPSADVISE_OUT_IN unchanged 
MMPSWRITE_MODIFIED_PACES unchanged 
MMPSCREATE_SEGMENT unchanged 
MMPSDELETE_ SEGMENT unchanged 
MMPSSTORE_SEGMENT_LATTRIBUTES unchanged 
MMPSFETCH SEGMENT_LATTRIBUTES unchanged 
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MMPSVERIFY_ACCESS unchanged 

MMPSFREE unchanged 

MMPSLOCK PAGES number of flocked pages per 
MMPSUNLOCK_ PAGES segment restricted to 32 
MMPSFETCH UPVA_UNWRITTEN_PAGES unchanged 


3012 STATISTICS FACILITY 


SFPSESTABLISH STATISTIC unchanged 
SFPSENABLE_STATISTIC unchanged 
SFPSDISABLE_STATISTIC unchanged 
SFPSDISESTABLISH STATISTIC unchanged 
SFPSEMIT_STATISTIC unchanged 
SFPSEMIT_SYSTEM_STATISTIC unchanged 


3.13 INIER ACTIVE FACILITY 


IF PSTERMINAL unchanged 
IFPSFETCH_ TERMINAL unchanged 
IFP$STORE_TERMINAL unchanged 
IFPSGET_LDEFLT_UTERMINAL_LATTRIBUTES unchanged 
IFPSGET_TERMINAL_ATTRIBUTES unchanged 
IFPSADVANCE new - *1 


*1 Oniy the option IFCSADVANCE_ALL_ QUEVED_OUTPUT Is supported. 


3e14 NOSZVE_EXCEPTIONS 


The following summarizes the exception code ranges currently 
assigned to NOS/VE. These code ranges represent ae finer 
breakdown than the one specified in the SIS for Internal NOS/VE 
development purposes. Hcwevers it is Important to remember that 
only the product identifiers documented in the SIS may appear in 
error messages». 


Common Modules 92000 - 95999 
Common Code Generator 8,000 - 85999 
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Product 


Exception Code Identifier Product Name 


1 = 1583999 Reserved . 
1592000 - 15959999 SY System Core 
1602000 —- 1699999 AM Basic Access Methods 
1609000 - 1632999 BA Basic Access 
1649000 —- 1649999 LN Local Name Mgr 
1653000 —- 1653999 JF Job File Mgr 
1669000 - 1665999 SR Conversion Services 
1702000 - 1793999 CL Command Language 
180»s000 — 1893999 JM Job Management 
1902000 — 1993999 LL Loader 
2002000 ~— 20939999 MM Memory Management 
2003000 =- 2043999 MM Monitor Level 
2059000 - 2053999 MM Task Level 
2109000 =— 2199999 OS QDperating System 
2102000 —- 2105:999 o$ 08 
2112000 = 2115999 MT EXEC 
2129000 = 2123999 Io MS 1/0 
21339000 —- 2133999 10 Tape 1/0 
2149000 —- 2145999 DM Device Management 
2159000 - 2153999 ML Memory Link | 
2162000 —- 2163999 IF Interactive 
2179000 —- 2173999 TM TM Monitor 
2183000 — 218,999 TM ™M Task 
2199000 = 21939999 JS Job Swappers 
22023000 — 2299999 PF Permanent File 
Management 
22139000 = 2215999 ST Set Management 
22239000 — 2223999 PU Permanent File Utitities 
2302000 —- 2399999 PM Program Management 
2402000 — 2499999 RM Resource Management 
2502000 — 2593999 OF Operator Facility 
2602000 - 2699999 AV User Administrator 
27029000 — 2799999 Ic Interstate Communication 
28029000 — 2899999 RH Remote Host Facility 
2902000 — 2993999 oc Object Code Utilities 
3002000 = 3099999 oS Deadstart/Recover y 
3102000 — 3199999 MS Maintenance Services 
3202000 - 3293999 IF Interactive Facility 
3309000 =—- 339,999 US User Errors 
3402000 — 3493999 SF Statistics Fac. 
3502000 —- 3599999 cM Configuration Management 
3602000 — 36959999 HU Help Utitities 
3709000 —- 37959999 NA Network Access Method 
5002000 —- 5093999 AA . Advanced Access Method 
5102000 — 5193999 AG ALGQOL 
5202000 — 5293999 AL Assembly Language 
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530,000 —- 53939999 AP APL 

540,000 -— 549,999 BA BASIC 

5502000 — 55959999 CA Conversion Aids System 
56029000 — 5699999 CB COBOL 

5702000 -— 5793999 CY. CYBIL 

5802000 —- 589999 FT FORTRAN 

5903000 — 5999999 PA PASCAL (Wirth) 
6009000 =- 6099999 Pl PL/1 

6102000 - 6193999 SM Sort Merge 
6209000. —- 6299999 sc Source Code Utility 
6402000 — 6499999 DB Debug 
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4.0 DUAL STATE DEADSTART AND OPERATION 


400 DUAL_SIAIE_DEADSTARI_ AND_OPERATION 


4.1 CURRENT DUAL STATE CONFIGURATION 


The Arden Hills $2 development tab contains 12 FMD units. 
o FMD Unit 43 (Che. ls 21s 22) 


This unit contains 0S permanent files. 


o FMD Unit 41 {Che 1s 2is 22) 
This unit contains the following: 
~ Files required to deadstart dual state Cycle 53; %Al7O NOS 
(5.3 plus changes necessary for Cycle 5)s5 CTIs MSL» EI 
binariess and NOS Deadstart files. 
- It is also used as atemp device. 
o FMD Unit 42 (Che ls 21» 22) 


This unit contains NOS permanent files. 


o FMD Unit 44 (Che 1) 
This is another NOS PF device. 
o FMD Unit 45 (Che 1) 
This unit contains files required to deadstart dual state 
Cycle 73; NOS 5E55 deadstart files CTI143PRs MSL143PR, and EI. 
It is also a NOS temp cevice. 
The following devices ere available for hands-on use: channel 


l» 21s 22: unit 403 charnel 29 22s 31:3 units 44 and 453 channel 
23 units 409 4159 429 and 43-6 
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4.2 USER _NAMES_ AND. PERMANENT _FILES 


1) The convention used for creating user names on NOS/VE is as 
follows? 
o Your user name will be your initials. 
o Your password will be these 3 Jletters followed by the 
letter 'x!, | 
o You must see COMSCURCE (R.K. Cooper - x3092) to be 
assigned a user Index 


2) PF dumping and loading 


You may use "“"SES,.CUMPPF"™ on SN/101 to dump your permanent 
Files to tapes and ther toad them onto your user name on Al17C 
NOS using “"SES.~LOADPF™. Documentation on how to use these SES 
procedures and what their parameters are is included in the 
SES Userts Guides or they can be obtained by typing: 


SESsHELP.sDUMPPF and SES»HELP.»LDADPF. 
4.3 CONVERTING VERSTON_1_ VALIDATION FILES 10 _VERSION_2 


The basic reference for this section is the NOS V2 System 
Maintenance Manual (60459300), Section 5-6 The best specific 
reference is Exampte 13 on page 5-37 In that manual. 


Using NOS 5.35 the analyst should do the following: 


XeDIS~ 

SUIs 377777. 

PURGE( SOURCE/NA) 

DEFINE (SOURCE) 

MODVAL (OP=#S» S=SOURCESFA) 
DROP. 


Next» the file SOURCE should be XEDNITed with the following 
directives: 


D/ABese ot /* 

D/INFese oz/¥ 

D/OF ee ot /* 
C/STANDARD/NORMAL/* 
C/CMLI/CNVE/* 
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Finally» after bringing up a NOS V2 systems do the following: 
(Notes An Iidie family situation must exist when the ISF commands 
are given.) 


XeDIS. 

SUIs377777. 

PURGE» NEWDUZ »NEWNDZ. 

DEFINE »sNEWDUZs NEWNDZ. 

ATTACHsSOURCE. 

MODVAL (OP=C» T=SOURCEsSTI9N=NEWDUZ sU=NEWNDZ) 

RETURN INEWDUZ» NEWNDZ) 

ISFs»R=NEWDUZ. (will release NEWDUZ if it is fast-—attach) 
ISF,sE=NEWDUZ. 

DROP. 


464 TO RELOAD CONTROLWARE FOR THE NOS/VE_DISK_ DRIVER 


At deadstart time NOS will automatically toad 7155-1x disk 
controtlware on one chanrel with controller type=FM (LBC CMRdeck 
entry)» and will automatically toad 7155-4x disk controtware on 
any channel with controller type=HT (LBC CMRdeck entry). NOS/VE 
supports both of those types of controllers. NOTE: It is not 
possible to use 844 half—track controlware in this environment. 


405 ALZO_NOS_DEADSTART 


4e5el CTI AND CHECKING CENTRAL MEMORY 


Deadstarting A170 NOS assumes some knowledge of CTI. CTI 
stands for Common Test and Initialization. It is software that 
places an 800 series machine in a state such that it Is possibje 
to deadstart an operating system. CTI is used somewhat 
ambiguously in the software community to tmoly CTI and MSL 
(Maintenance Software Library). The MSL is a collection of 
programs and data that includes such things as a subset of CMSE 
{Cyber Maintenance Software Executive) that enables one to toad 
controlware to control lerss fook at CYBER 180 maintenance 
registers» fook at microcodes etc. The MSL also contains 
microcode that can be toaded by CTI. The MSL is actually an 
operating system that runs Independently of NOS. An important 
element of CTI/MSL Is HIVS {Hardware Verification Sequence) » 
which Is a program that toads microcodes clears and checks 
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4.0 DUAL STATE DEADSTART AND OPERATION 


4s 25a CTI AND CHECKING CENTRAL MEMORY 


PO ne 90 Pb 08 ee le Had we re DERE BET PERE OE PE FOE POE PO POPE P88 08 8 EOE PO TE PEPE PPE TM MMMM MH 


central memory and tests af] 170 opcodes. If you are not sure 
what the machine was used for (particularily the first hands on 
user each morning) then the HIVS program should be rune This is 
accomplished by: 

1) deadstart to NOS/VE (unit 40 for S35 unit 45 for $2) 

2) Enter 0 (operator intervention) 

3) Enter P (deadstart panelsmake sure fevel 0 deadstart) 

4) <BKSP> 

5) Enter H (assure yourself that CS=YES to reload microcode) 

6) <BKSP> 

7) Enter V (verification sequence) 


B) Hit <CRD> at 'parameter display’ to test CM & CP 


When you see text that tells you that verification is complete 
and a deadstart is required, you are now ready to deadstart NOS. 


42522 NOS DEADSTART 


See Section 3.3 of the Integration Procedures Notebook for 

important NOS CMRDECK changess 

o Set the D/S panel to deadstart from the primary system disk. 
This is 844 pack P0345 for 921 and 844 pack P0367 for 922 and 
subsequent systems. 

o Push D/S button 

Enter (CR) 

o Enter date/time 


° 


Wait for deadstart to complete, 
Notes: The deadstart tapes DUQLA and DUS2ZA for 9.21 and 92 


respectiveiy are found in the area in the northeast corner of the 
$2 lab where the tape cabinet is found. 
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4.0 DUAL STATE DEADSTART AND OPERATION 
406 NOS/VE DEADSTART AND INSTALLATION 
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4.6 NOSZVE_DEADSTART_AND_ INSTALLATION 


Enter DOWNsCH2. so NDOS/VE can use the channel. 
Enter DOWN»sCH32. so NCS/VE can use the channel. 


The following file must be availabie in your catalog on the 
$2: 


TPXXXK contains a NOS/VE deadstart image. This must be a copy of 


the 


duai. state deadstart images availabte from the tink 


procedures. 


9 


If you've never deadsterted NOS/VE from the user number from 
which you want to run or if you wish to change the current 
parameter settings for your particular user numbers, then do a 
SETVE. SETVE assumes the file TPXXXK is in your user numbers 
you do not have to do another SETVE $F TPXXXK has changed 
Since the last time you rane The general form of SETVE tis: 


XsSETVECPN=Fff FF s»UN=uns C=6) 
where Ffff Is an Identifier of uo to 4 characters and un is 
the user number to search first for files. 6 is the number of 
the system core cemmand deck for the Arden Hills $2 
configuration. Warning: Specifying C=6_on the Arden Hilis._33 
wlil.destroy the closed shop _cermanent file bases. In general 
ffff and un will be the sames eegs XeSETVE(DAHsUN=DAHs C=6) 
**Onily ONE SETVE should be done for each user number and 4a 
SETVE shoutd NOT be done for ANY Integration user number 
except by the Integration pro ject.** 
SEE SECTION 5.1 FOR MORE DETAILS. 
Bring up dual state: 
NVE fff. 


where fFTf Is the identifier specified in SETVE>s Pegs 
NVEINT1. 


Bring up the Operator Facility 
Enter KsNVE. 


NOS/VE ts currently generated and initialized on both NOS 
and NOS/VE. Ail source and object tibraries that make up the 
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NOS/VE system are produced on NOS and therefore must be 
converted from thelr CI to II counterparts. Other parts of 
installing and initializing the system (e.g. building the 
SSYSTEM catalog) are performed by command language procedures 
on NOS/VE. Since the same system will many times in a closed 
shop environments it is advantageous to only perform the 
conversion from CI to II a single time; save the results in 
the NGS file system and then simply bring the files back 
during deadstart. 


The actual files thet get installed and toaded on each 
deadstart are determined by a command tlanguage procedure (the 
system profile) interpreted on NOS/VE. This procedure can be 
modified by each site to initialize their NOS/VE environment 
in the most sultable fashion. The process of bulliding the 
system profite and of performing the CI to II conversions is 
referred to as an installation deadstart and the process of 
executing the system profile and of fetching previcsusly 
converted files from NCS and making them available in the 
NOS /VE file system is referred to as a deadstart. A single 
command is available to perform both an installation deadstart 
and a deadstart. 


4e601 THE DS PROCEDURE 


The purpose of this command is to perform an installations 
normal or recovery cdeadstart of NOS/VE. The defaults for 
parameters are those most convenient for “closed shop" 
deadstarts. 


The procedure "brings up™ the job log display on the fteft 
screen where the progress of the procedure may be watcheds and 
the control point display on the right screen. Just before 
the procedure completes it changes the left screen to display 
the system fog and writes to that tog the message: 


teem-= Qeadstart Completed ----' 


at which point the operator may enter commands. 


ds Ckindzinstalt ? norwsal ? recover] 
Cget_products=<boolean>] 
Cecho=<bootean>] 
Caiternate_user=<NOS_user_name>d] 
Csave_instali_ files =<boolean>] 
Cvalidate_users=<boolean>] 
Cquick_validate=!list of <name>} 
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(status=<status var iable>] 


kind : ks: This parameter specifies what kind of deadstart Is 
to be performed. Valid specifications are: 


install ? I - instaliation deadstart to be performed, 
The system tlibraries are bulit from CI object 
files. 


normal i n- normal deadstart to be performed. The 
system Jibreries are obtained from the results of a 
previous installation deadstart. 


recover 3; rf ~ recovery deadstart. Just initlates system 


tasks. Permanent files are "recovered" from a 


previous run of the system. 


Omission wiil cause a recovery deadstart to be 
performed. 


get_products $ gp: This parameter specifies whether the object 
jibraries defining the current product set and SCU 
libraries defining the source libraries are to be 
installed. Valid specifications are: 
true { yes { on — the products are to be installed 
faise i no } off - the products are not to be instalied 
The fist of preducts iInstatlied on the Arden Hilts 
closed shop $3 system when get _products=yes is specified 
is given in the INSTALL PRODUCTS section. 
Omisston will cause the product set to be instatied. 
echo } e: This parameter specifies whether the commands shoutd 
be echoed to the consoiea during executions Valid 
specifications are: 
true } yes { on — echo commands 
faise 3} no } off = do not echo commands 
Omission wil! cause commands not to be echoed. 
alternate_user i aut This parameter specifies what NOS user to 
check if the default NVE user does not have the needed 
file. Any NOS user name Is allowed, 
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Qmission wil! cause INT1 to be used. 
validate _users { vu: This parameter specifies whether to run 
the job that vatidates NOS/VE users. This parameter is 
ignored for a recovery deadstart. Valid specifications 
are? 
true i yes } on ~ run the validation job 
faise $ no 3 off - do not run the validation job 
Omission will cause the validation job to be run. 
quick validate { av: This parameter determines which users 


will be validated by the validation job if it is rune 
When specifieds this parameter gives a list of user names 


to be validated in addition to the users: INTl» INT2) _ 


DEV1l» DEV2s REL1l» EVAL and RKC. 
Omission wilt cause all users to be validated. 


status? See ERROR HANDLING In the NOS/VE ERS. 
NOTES 


The get_source_libraries parameter has been removed. Source 
libraries are now treated as products and their iInstalttiation 
is now controtlied by the get_products parameter. 


The debug parameter has also been removed, Later in this 
document there is ar explanaticen of how ODS now handies 
abnormal situations. 


Sumpary_of 0S. Processing 


Kind.of_ Installation Processes Performed 


In No R A condition handier is estab!fished for 
any fauit. If something goes wrong 
during the OS procedures it will) get 
controls display the statuss and tet 
the operator interact with the O8§ 
procedure. The operator can enter 
commands to investigate and/or correct 
the problems resume execution of DS by 
entering CONTINUEs or abort ODS oby 
entering EXIT _LPROC. 
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4.0 DUAL STATE DEADSTART AND OPERATION 


G4e6e1 THE DS PROCEDURE 


I» 


I only 


N only 


I» 


I» 


Ne» 


No» 


N» 


The procedure "brings up™ the job log 
display (on the left screen) where the 
progress of the DS procedure may be 
watcheds and the control point display 
{on the right screen). 


System files are created from 170 CI 
binaries for 


CYFSRUN_TIME LIBRARY 
OSFSOPERATOR_LIBRARY 
OSFSSYSTEM_LIBRARY 
OSFSNPERATOR_COMMAND_LIBRARY 
OSFSCOMMAND_LIBRARY 


If save_install files=yes, the II 
binaries of the above Files are 
repiaced on the 170. 

System files are accessed from 170» 
these are the replaced [I binaries 
mentioned above. 

Remote Host Output is started. 


System and User Prologs and Epilogs 
are built. 


The validation job is submitted and 
system statistics are output. 


If get lproducts=yes,» the product set 
and source ttibraries are instalied; 
failed product set or source tibrary 
Installations wild orint a job tog. 
Wait for validation job to complete. 


RHINPUT»s IFEXEC,s DUMP_BROKEN_JOB tasks 
are started. 


Feedback capability set up. 

SCL task started. 

Job fog printed. 

The following message is output: 


-- Deadstart Completed -- 
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The blaggest change to the DS procedure is in the product 


set installation (get_productszyes). A procedure called 


INSTALL UPRODUCTS is used to instal! the entire product set 
{product set and source tibraries). In this procedures a job 
is submitted for each products in each job a GET_PROOUCT is 
executed. The products are installed in the SSYSTEM.LIBRARY 
catalog under the product name. The submitted jobs can be 
viewed on a right K displays the fteft K display shows the 
processing of the DS procedure. 


Upon job completions a success or failure message with the 
dob name {reflecting the product being instaileds i.e. 
cyigcomplier for product cyf$compiler - the CYBIL II Compliter) 
is written to a status file (dsf$product job _status). The 
contents of this file Is used to make sure all the product 
jobs have completed tefore continuing with the DOS procedures 
as well as the contents being displayed to the job iog which 
can be viewed by the operator. 


If a product Installation fails»s several things happen: 


- A failure message with job name is written to the status 
files which will subsequentiy be displayed to the 
operator. 


- The Job tog for the falled product installation will be 
printeds indicating the error. 


- At the end of the INSTALL PRODUCTS procedures if any 
products have falleds the condition handler established 
at the start of the DS procedure gets controli. <A status 
message of "n product installations failed” is displayed 
and a prompt fcr operator interaction occurs. The 
operator at this point can attempt reinstallation of 
falled products through the use of INSTALL PRODUCTS or 
just continue with the DS procedure. 


The INSTALL PRODUCTS procedure can be used as an 
independent command to do an installation/reinstattation at 
the operator's discretion. 


If get _products=zyes» all of the following will be 
installed. 
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C170 Product Name 


Eils {€180_File) Eile Contents 

cyfiic CYFSCOMPILER CYBIL II Compller 

alfol ALFSOBJECTLLIBRARY 180 Assembler 

scfol SCFSOBJECT LIBRARY Source Code Utility 

scfcl SCFSCOMMAND_LIBRARY Source Code Utility 
"stand-alone™ command 
fibrary 

iffedit IFFSEDITOR Jack Bohnhoff's Editor 

psfcl PSFSCOMMAND_LIBRARY Product Set Commands 

aaf44d AAFS44D_LIBRARY AAM Library 

aaf4dd AAFS4DD_LIBRARY AAM-Fortran Interface 

cbf 7dd CBFS7DD_LIBRARY Coboi Compiter 

cbf4dd CBFS4DD_LIBRARY Cobol Run-Time Library 

ccflib CCFSLIBRARY Common Compiler Modules 

caflib CGFSLIBRARY . Common Code Gener ator 

dbflib DBFSLIBRARY Debug Library 

feflib FCFSLIBRARY Fortran Compiter 

fiflib FLFSLIBRARY Fortran Run-Time 

Fmfiib FMFSLIBRARY Flie Management Utility 

miflib MLFSLIBRARY Math Library 

smflib SMFSLIBRARY Sort-Merge 

ttflib TTFSTEST_TOOL_LIBRARY Test Tool Library - ACR 


& Examine 

osfpil OSFSPROGRAM_LINTERFACE_LIBRARY Operating System Program 
Interface 

osfsi OSFSSOURCE_LLIBRARY Subset of Operating 
System Source Library 


INSTALL PRODUCTS Procedure 


install products [Cproducts=!ist of <name> ? all] 
Cstatuszstatus_variable] 


products ! product { p: the names of one or products to be 
installed. 


Omission willl cause af! products to be installed, 


status: See ERROR HANDLING In the NOS/VE Command Interface ERS 
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GET_2PRODUCT. Procedure 


get _product product=<name>d 
file=<170_file name> 
user=<170_user name> 
Ceatalog=<180_catalog_reference>] 
Cite _contents=<name>d] 
(file structur e=<name>]. 
{fille _processor=<name>] 
Cring_attributeszlist 3..3 of <integer>] 
Cstatus=status_variablie] 


product i p2 name of the product 


file 3} f3 name of the 170 file that contains the 856 form 
of the product. 


user ? u? name of the 170 user that owns “file”, 


catalog } ci name of the catalog in which the product is to 
be installed. 


Omission will cause SuSer to be used. 


file contents { File _cntent i fe? the value for the preduct 
file's file_contents attribute. 


Omission will cause object to be used. 


file structure {| fs: the vaiue for the product filets 
file structure attribute. 


Omission will cause ltibrary to be used. 


file processor $} fp: the value for the product filets 
file processor attribute. 


DOmisston wlll cause unknown to be used. 


ring attributes { ra: the values for the product file's 
ring attributes attribute. 


Omission will cause (11ls1l1ls11) to be used. 


status: See ERROR HANDLING in the NOS/VE Command Interface ERS 
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If you change any of the following decks you MUST use the 
installation deadstart from your own catalog (with files 
CYBILGOs XLJOCMs XLJOSL and xXLJLIB)» or you must use the 
alternate_user parameter to specify a NOS catalog containing 
the files (eege DEVI). 


AVMUTIL CLMDP DMMDISA ICMCLOS ICMFAI ICMFAPC ICMFLSH ICMGET 
ICMOPEN ICMPUT ICMWEOP ITFMEXEC TIMA72H IIMDC2S IIMRLE 

TIMRSE IIMRUM ITIMRUS* TIMTDEL OCMADD OCMBIM OCMBIM OCMCOL 
OCMCOM OCMCPY OCMCRM OCMDEF OCMDEL OCMDLB QOCMDNL 

DCMDDL OCMEND ACMGEN OCMLCH OCMLMG OCMLP OCMMUR 

OCMNP OCMOBJ OCMOFH OCMOMS OCMRCH OCMRED OCMREP OCMRMB 
OCMSAT OCMSOL OCMVEL OCMVLU OCMVOL PFMDC PFMTALL 

PUMBCAT PUMBCYC PUMBFIL PUMBFO PUMBLST PUMBPF PUMBSET 

PUMCOMN PUMCRAK PUMPURG PUMCRAK PUMIDBF PUMLIST PUMMISC 

PUMPURG PUMRALL PUMRCAT PUMREC PUMREF PUMRFIL PUMRPF 

PUMSTUB RHMLML RHMQAT RHMQDP RHMQRE RHMSFM USORT UTM DUR 
UTMPC1l UTMPC2 UTMPC3 UTMPC4 UTMPC5 UTMTSA UUSERI 


44622 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 
Type 
KaNVE. 
KeSETLA Cyour_un»sNVE) your password 
K»GETF 0S Usscat 
KeDS INSTALL GP=NO AUsscat 
40623 EXAMPLE OF NOS/VE “NORMAL” DEADSTART 
The Intearation system has had the installation deadstart 
run on tt. Also the files produced by the instailation 
deadstart have been made semi-private and are found on the 


catalog used In the NVExxxx call. 


Type (where DEV1 is the same as the xxxx in the NVExxxx 


cali): 

Ka NVE. 

KeSETLA (DEVI»sNVE) DEV1IX 
KeGETF DS 


KeDS NORMAL 
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4e6e4 EXAMPLE QF NOS/VE RECOVERY DEADSTART 


This Is the kind of deadstart that should most freaquently 
be done in a "closed shop" environment and consequenttiy is the 
one for which all the parameter defaults are oriented. It 
presupposes that permanent fille recovery has been successful. 


Type (where DEVI is the same as the xxxx in the NVExxxx 


call): 

Ka NVE. 

KeSETLA (DEVI»NVE) DEVIX 
KeGETF DS 

K.DS 


4.605 EXAMPLE OF MINIMAL NOS/VE DEADSTART 


The minimal deadstart shown below may be useful te 98 
developers who need to get the system up quickiy and do not 
need the product set or all validated users. 


Type 


Ka NVE. 

KeSETLA (your lunsNVE) your password 
KeSETF DS Uescat 

KeDS NORMAL GP=NO QV=your_un AU=scat 


4.6.6 USE OF THE QUICK_DEADSTART COMMAND 


This command is intended as a development tool to 
facilitate ‘'fast' deaedstarts where recovery is not needed; 
indeeds if this commard is entered recovery.__will_npot._ibe 
pecforcmead when the system is brought down for whatever 
reason. Specifying this command will cause an Instaltatior 
deadstart to take place. If the INITDOD command is not 
specified then a default vatue of *"VSNOO1' is used for the 
system deadstart device. Use of INITOD will aliow setting the 
deadstart devices identifier to any value. THIS COMMAND WILL 
NOT BE ACCEPTED FROM A DEADSTART COMMAND FILE, SO 'D=T* MUST 
BE SPECIFIED ON THE SETVE PROCEDURE TO PERMIT ENTRY QF THE 
QUICKOS COMMAND. 

Format: QUICKDS or CQUICK_DEADSTART 

Values: The defauit is false. Executing this command 
causes this initial value to be toggieds thus executing this 
command twice will cause the final value to be false. 

Notes: QUICK_TEMPLATE_LOAD does not exist now. 
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4.7 NOSAVE_INTERACTIVE FACILITY. OPERATION 


4e721 OPERATOR INITIATION 
To bring up the NOS/VE jinteractive facility do the 
following? 
1) Bring up NOS/VE. 
2) Bring up NAM 


At the system console enter: 


For 9.21/5F:3 For 9242/5G: 
FCN» 597700. ENABLEsNAMs?e. 
NAMV2. NAM, 


With the 56 networkss a flashing request for a dump 
tape will appears, enabling the operator to dump a 
previous network crash after bringing NAM & friends up 
again. If you den*tt want a dump enter ASSIGNs jsns77. 
for the appropriate job. 
3) If IAF is not up at control point 1» enter; 


For 9.1/5F: For 9.2/563 
IAFV2. IAF. 


447.2 OPERATOR TERMINATION 


4.7e2e1 Terminatilon_of_1_ Series Networks. -_9,1/3EF 
To terminate NOS/VE interactive any of the following may be 
done? 
- CFOsNAM.~DIsAP=VEIAF. 


This is the preferred method. To bring NOS/VE interactive 
back ups you must first do a CFOsNAM.~ENs AP=VEIAF. 


acs CFOsNAM.DIsNE. 
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This terminates the entire network including IAF»RBFs etce 


4o7e2e2 JTecmination of 4 Series Networks —-_922/5G 


To terminate NOS/VE interactive either of the following may 
be done. 


- Preferred method: 
KeNAM. 
K .AP=NVF. 
K»O0IsAP=VETIAF. 
To bring VEIAF beck ups you must do: 
KaNAMe 
K »AP=NVF,. 
KeEN»s APHVETAF.. 
XeDIS. 
IIPPAS. 
DROP. 

~ Second method: 
IDLE» NAM. 


IDLE, TAF. (Don't idie IAF when IAFEX2 is executing 
or a PP will hang.) 


This terminates the entire network including IAF» RBF» 
etce and should be used onty if you have po_intention of 
bringing VEIAF back up because the 170 and 180 sides of VEIAF 
get out of synch when the network is brought down this way. 


4$o723 OTHER OPERATOR CAPABILITIES 


- To logically turn the printer ons under DSD enter: 


ON» 33+ 
FORM» 332TMs. 


- To send a “shutdown warning™ to atl terminalis togged on to 
VEIAF do? 
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4.7 


23 OTHER OPERATOR CAPABILITIES 
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For 9.21/5F: For 922/563 
CFO»sNAMeIDs AP=VEIAF. KaNAMe 
K eAP=NVF. 
KeiDsAP=VETAF. 


~ Jo send a message te all terminais do: 


For 9.1/5F: For 922/5G:3 
CFO »sNAM.MSGsALL»message. Ka NAM. 
KeAP=CS. 


KeNPU=npunamesmessages 
npuname=5N1147 on the S$2>s 
=SN1322 on the $3. 


- PASSON has the aktility to record various tyoes of 
diagnostic information. This capability is controlied via 
the sense switches at the PASSON contro! point. To turn a 
sense switch on (off) at job jsn do: 


ONS Ws Isnsx. (OFFSWs Isnsx.) 


where x is the desired sense switch (1 to 6). The PASSON 
default is all sense switches off. It will take a short 
period of time before PASSON detects a change in a sense 
switch and reacts toc ite. The sense switches currently used 
by PASSON are: 


suitch# use 
1 Network Trace 
2 PASSON Logic Trace To Dayfile 
3 Memory Link Trace To Dayfile 


408 NOSCVE_OPERATOR EACILITY AND_OPERATOR COMMANDS 


With the release cf the Operator Facility Phase 1 several 
changes to the NOS/VE Cperating System will occur that will 
effect the users of the NOS/VE Gperators Console. The 
Operator Facility runs as part of the NVE contro! point. When 
the request for K display appears on the NOS B Displays assign 
the K Display to the NVE control point. The Operator Facility 
js capable of displaying both a teft and aright screen area 
at the same time. If the operator wants both screens then 
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type in KK. The conterts of these displays ar2 determined by 
the commands entered by the operator. 


The feft screen is divided into four different areas. The 
top most area is the system header which contains the current 
date and times memory statisticss and an operator action 
message if one is pested. The operator action will include 
the job sequence number of the owner of the message and 
‘message cancelled? if the message is cancelled because the 
task has terminated. The next tine contains the first 64 
characters of the operator action message (60 characters in 
stand alone). 


The next area of the screen is the main output area. This 
area has the file name of OUTPUT. <Any display command can 
have its output directed to this area as well as any system 
commande 


The third area is towards the bottom of the screen. This 
area is two tines tong and contains the response area. This 
will contain error messages from system commands. The area is 
cleared when the next operator typein is entered at the 
operator's console and received by NOS/VE. 


The fourth area is the prompt area. This wiil contain the 
status of the keyboard. If NOS/VE is processing a command» 
then the keyboard is tocked and all typeins will be ignored. 
When the keyboard is lockeds the message "data received by 18C 
- keyboard tftocked' will appear at the screen's bottom. When 
the keyboard is unlocked then any data in the keyboard buffer 
will be sent to NOS/VE. The bottom Tine is the last tine that 
was processed by Operator Facility. 


The right K Display has the file name OUTPUT_RIGHT. There 
is only one area on the right screen therefore the main 
display area is 10 fines tonger than the left screen area. If 
a dayfile disptay or CP display is shown on the right screen 
you will get more fines of information than on the teft 
screens 


There are no default displays that come up automatically on 
either output display area. It is up to the operator te 
decide the display the operator wishes to seee The only parts 
of the display that come up automatically is the system header 
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display and the prompt area for keyboard status. 


The page width cf the screen is 60 characters for 
standalone and 64 characters for duai state. The character 
set translation code is the same as that for the current NVE 
Subsystem contro! point. The escape code sequence for the 
special characters te be typed has not changed. There are a 
few differences in the processing of data by the Operator 
Facility and NVE Subsystem. 


1) Do NOT end commands with a period. Periods are sent to 
NOS/VE. 


2) The NVE subsystem commands that begin with an asterisk will 
not be supported from the Operator Facility control point. 
If these commands are entered from the Operator facility 
they wlil be passed on to SCL where an ilflegai command will 
be issued. 


3) Routing of console job data to a specific job by the 
'ascommand! protoccec! will not be supported in dual state. 
This feature shoutd work in standatone but will not be 
supported. 


4) No type ahead - commands cannot be entered until the prompt 
area shows that they are requested. 


There is one new command to replace the current display 
commands. The entry pcecints for Zdiss» Zdisbs and Sdis have 
been deleted. The new command is VEDISPLAY and has two 
parameterse The options are listed below. The values in 
paranthesis are the abbreviations. Note that this command 
does not begin with an asterisk (*). This command will be 
processed by SCL and create a new system control point task to 
display it*%s data. The user can have the same display type on 
each of the display areass if the user so desires. 


Command Name Display Type Screen Area 
Par ameter Name Parameter Name 
DISPLAY OPTIONS OUTPUT (0) 


DISPLAY_OPTION (D0) 
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Parameter Values Parameter Values 
VEDISPLAY (VED) DIS PLAY_SYSTEM_LOG OUTPUT 
. JOBLLOG (JL) | OUTPUT RIGHT (OR) 
CONTROLLPOINT (CP) 
The default fille name for ali displays is OUTPUT. 


The following is a trief fist of commands to bring up NOSVE 
with the Dperator Facility installed. 


NVE Tf Tf. to tring up NOS/VE. (See Section 5) 
K»aNVE. 

KK to bring up the K display on both screens. 
KeVED JL to tring up the job log. 


or 
Ke.VED DISPLAY_OPTIONS=JL OQUTPUT=OUTPUT 
to bring up the job tog using key word 
identifiers. 


KeVED CP OUTPUT_LRIGHT 
to tring up the controi point display on 
the right screen. 
or 
KeVED DISPLAY_LOPTIONS=CONTROL POINT OUTPUT=OUTPUT_ RIGHT 
to tring up the contro! point display using 
key — word 
identifiers. 


Ko Xxx send any command to NOS/VE. 


KeTERMINATE_SYSTEM to terminate NOS/VE. 


Note: After the DS procedure has completed execution the 
command to enter to bring down the system is TERMINATE_SYSTEMs 
not TERMINATE_SYSTEM_JCB. Yess this is the OPPOSITE of what 
it used to be. 
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4.8.1 DELETE. JOBLQUEUE i DELETE_JOBLQUEVES {! DELJO 


The purpose of this command is to delete ali files from the 
job input subcatalogs the print subcataiog or both. This 
command is onty ailowed from jobs with operator and or system 
privileges. 


delete. job queue [queue _name=inputioutputiali] 
Cstatus=<status variabie>] 


guevue_name } qn: This parameter specifies from which 
subcatalogs files are to be deleted. Specifying 
INPUT will cause all files to be deleted from the 
jeb swap subcatalog and the job input subcatatog. 
Specifying OUTPUT will cause all files to be deleted 
from the Job output subcataloge. Omission will cause 
all to be used. 


status: See ERRDR HANDLING. 
4.8.2 REBUILD_LINPUT_QUEUE $ REBIO 


The purpose of this command is to rebuild an entry in the 
Known Job List (KJL) from information in the System Label of 
the file representing the job being processed. This command 
is to be used during the process of recovering the Input 
queues during recovery deadstart. 


rebuild Input queue (C€neme=<name>d] 
C{status=<status variable>] 


name | n: This parameter specifies the file name of the 
file representing the Jjobe An attempt is made to 
process the specified flie within the catalog where 
job input queues are known to reside. 


status: See ERROR HANDLING. 
42.8.3 REBUILD_OUTPUT_QLEVE $$ REBOQ 


The purpose of this command is to rebulid an entry in the 
Known Output List (KOOL) from information retained in the 
System Label of the file representing the output being 
processed. This command is to be used during the process of 
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recovering the output cueuves during a recovery deadstart. 


rebulld_output queue [ name=<name>] 
Cstatus=<status varlablte>] 


name: This parameter specifies the file name of the file 
representing the output. An attempt is made to 
process the specified fille within the catalog path 
of where job output queues are known to reside. 


status: See ERROR HANDLING. 


4.9 ROUTE _AN_INPUT_EILE FROM _€170_10_€186 


Through the system consoles enter: 
Type 


XeDIS» 

USER» AaB. 

GETsfilename. 

where filename identifies the input file to be routed. 
ROUTE sfilenamesDC=LP»sFC=RH. 


4010 CONEIGURATION MANAGE KENT 


In order to run NOS/VE in a dual state environment» certain 
hardware configuration rules must be in effect. Ali storage 
devices and channels that NOS/VE will request must be in a 
*down' state in the NCS EST.’ For more information on the NOS 
EST» see the NOS Version 2 Qperator/Analyst Handbooks 
604593105 Section 4. Refer to the E display. 


To run $2 S/N 104 in the standard configurations channels 2 
and 32 must be downed es shown below. 


DOWNs CH2. 
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4210.1 SYSTEM CORE COMMANDS 


Configuration Management (CM) system core commands define 
the system mass storage device. The commands are described in 
detail in the NOS/VE Installation Command Interface ERS» 
Section 3. The CM system core commands define the hardware 
configuration of the system device and the controller 
accessing the system device. An exampie for $2 S/N 104 is 
shown here. 


SETDOCT $7155_1 
SETDD $885_11 40(8) 


4.10.2 JOB TEMPLATE COMMANDS 


During an installation deadstart»s the Physical 
Configuration Utility (PCU) and the Logical Configuration 
Utitity (LCU) must be rune The PCU is run to describe the 
physical configuration that NOS/VE may access. The LCU will 
logicaliy instal! ali or part of the physical configuration 
and allow NOS/VE to access the equipment. Commands for both 
utilities are described in the NOS/VE Installation Command 
Interface ERS» Section 2. 


The system device which was defined by the system core 
commands must the defined via the PCUs using the same 
controller and channel number... Additional devices may be 
defined as tong as the device is in a down states and all 
channels defined are also down. An example is listed here, 


EXECUTE_LTASK SP=MANAGE _PHYSICAL_CONFIGURATION 
SETLMAINFRAME_ DEFINITION MAINFRAME =S2 
SETL-DATA_CHANNEL_DEFINITION CHANNEL _NUMBER=2 
SETUDATALCHANNEL DEFINITION CHANNEL _NUMBER=18 
SET_CONTROLLER_DEFINITION ELEMENT=CT1 .. 

PRODUCT_IDENTIFICATION=$7155_1 .. 

SERTAL_NUMBER=2 CHANNEL _ CONNECT ION=CHANNEL2 
SETLCONTROLLER_DEFINITION ELEMENT=CT2 .. 

PRODUCTLIDENTIFICATION=$7155_1 o. 

SERTAL_LNUMBER2=3 CHANNEL CONNECT ION=CHANNEL18 
SETLSTORAGE_DEVICE_ DEFINITION ELEMENT=FMD40_A o>» 

PRODUCT_LIDENTIFICATION=$885_11 SERIAL_NUMBER=1234 2. 

UNITUNUMBER=40(8) CONTROLLER_CONNECTION=CT1 
SETLSTORAGE_DEVICE_CEFINITION ELEMENT=FMD40_B oe 

PRODUCTLIDENTIFICATION=$855_11 SERIAL_NUMBER=3456 o. 
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UNIT_NUMBER=40(8) CONTROLLER_CONNECTION=CT2 
INSTALLLPHYSICAL_ CONFIGURATION MAINFRAME=S2 
QUIT 


EXECUTE_TASK SP=MANAGE_LOGICAL_ CONFIGURATION 
INSTALL_LOGICAL_CONFIGURATION INCLUDE=ALL 
QUIT 


4.10.3 MULTIPLE VOLUME COBMSIDERATIONS 


If a configuration is used defining multiple mass 5s 
volumes» the execution of the PCU and LCU will only 
access to the systen device. In order to bring addi 
volumes onlines the LCL must be run again. The user may 
to initialize a fresh volume. To do thiss use t 
subcommand INITMV. To add a volume to the NQS/VE sets 


torage 
permit 
tional 
want 
he LCU 
bes 


to allow NOS/VE use of the volumes use the LCU subcommand 


ADDMTS. An exampte is shown here. 


EXECUTELTASK TP=MANAGE_LOGICAL_CONFIGUATION 


INITIALIZE_MS_ VOLUME ELEMENT=FMD40_B RECGRDED_LVSN="VSNOO02! 


ADD_MEMBER_TO_SET MEMBER_VSN='VSNOO2* 
QUIT 


During a noninstalletion deadstarts an attempt will be made 


to bring all fogicaily configured volumes ontin 
reactivate them. This means the above seguance need 
occur when 8s new volume is being brought online the 
time. 


e and 
only 
first 


Reference has been made to the NOS/VE Installation Command 
Interface ERS. To get a copy of this document on S/N 1Cl>» 


enter SES»sMAD.LISTNIH. 


4011 K_DISPLAY ASCII 


Support of 6-12 ASCII from the console (K display) 
the following changes: 


INPUT IRANSLATED_19 INPUT TRANSLATED 10 
fi /{ { 
4/2” /) 3 


causes 
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43 # i+ > 

14 % /=- € 

75 (reversed /) {= * 

46 3 /* * (stngle quote) 
47 2 4/ / 

8 f /» 3 

49 3} 4&i to /Z2 an 2z (lower case) 


70 — (underscore) 


4.12 EDD_AND_DSOI_INEQRMAJION 


Most of the steps Jisted here are used to gather 
information for recovery problemss etc. If you do not wish to 
do this»s execute steps D and E only (EDD dump and NOS tevel 3 
deadstart). 

A. Enter DR I at the MDD display. 

B. Enter HP at the MDD display. 

C. If IOU.FS1 NOT = 0 GR INU.FS2 NOT = 0 THEN do NOT enter 

DU at the MOD display ELSE do enter DU at the MDD 
display. 

De Press deadstart button and perform EDD: 

1) Mount scratch tape (ring in) on a J-track drive. 
2) Push D/S button. 
3) Select U (utilities) display. 
4) Setect E (EDD) display. 
5) Set channel (S2=13). 
6) Set ECUU (S2=Oluu) 
—E = equipment 
C = 1 for 67X drivess 2 for 66X% drives 


uu is = unit number of the tape drive to be used. 


7) Answer “dump number" with a CR. 
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8) Answer “non zero inhibits rewind™ with a CR. 


9) Answer “channel controlware™ with a CR. Warning: 
if this step is omitteds DSDI canot process the 
dump tape. 


E. Perform a tevel 3 NOS deadstart (See Section 4.14). 


Fe If you are runnirg on the $3» enter the following at the 
console: 


XDIS. 

USER» INTIsINTIX. 
GET» DMPDFS/UN=JLG. 
BEGIN»ss DMPDFS. 


DROP. 


This is a procedure to dump several dayfiltes associated 
with the NVExxxx job and are needed along with the EDD tape to 
adequately debug a NOS/VE hange 

Some of the crashes that NOS/VE encounters will cause 
NOS/VE to terminate such that the operator will notice the 
K-display which requests that a K.*RUN. be entered. Before a 
Ke *¥RUN. is entered the EDD should be performed. 

To create a ftisting of the EDD tapes type SESs»sINT1.DSDI See 
the procedure'ts HELP documentation for parameter 
descriptions. 


C170 DSDI Information can be found in Chapter 10 of the NOS 
SYSTEM MAINTENANCE Manual. 


A170 DSDI info can te found in document ARH3060 -- GID for 
A170 NOS/S2. 


4013 NOSZVE_TERMINATIO‘“ 


o Bringing down dual state: 
Ke NVE. 
Ke TERMINATE_SYSTEM 
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o If not anormal terwrination 
K» NVE. 
Ks *RUN. 


K.*ENDLST. 
Ke *ENDRUN. 


4014 A1ZO_NOS_SHUTDOUN 


Before leaving the machines it is necessary to bring NOS 
down. If NOS has crasheds a level 3 deadstart must be 
attempted even if the conly reason is to bring NOS downe To do 
a level 3 deadstart: 

1) Push D/S button 

2) Setect "0" display 
3) Setect "P" display 
4) Enter I=3 

5) Enter (CR) 

6) Enter date/time 

If a dump is desired but a crash has not occurred STEP. 
should always be entered before pushing the deadstart button. 
After the dump has been taken a level 3 deadstart should be 
performed. 

To bring NOS downs do the following: 

1) Enter: 
CHE 
The screen will display: 
CHECK POINT SYSTEM. 
Enter: carriage return 

2) Make sure no mass storage device has ae checkpoint 
rquested. To do this»s enter: Es. If the display shows 
there are no "C"s in the status fields then all devices 
are checkpointed and you may continue. 

3) «Enter: 
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STEP. 


4) Push deadstart button. 
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500 RECOVERY OF _NOS/VE_PERMANENT FILES 


Del SEIVE_EQRMAT 


The general format of the SETVE command is 


XeSETVECPN=FFFFs UN=uns VS N=vsne D2ds P=ps B=bsC=csCH=ch) 


frrf 


un 


is a string of no more than four characters. SETVE 
appends ffff to 'NVE® to construct the name of a 
procedure file whichs when invokeds will deadstart 
NOS/VE. The default is TST. 


specifies the user number from which TPXXXK is 
attached. in ts the first catalog searched for 
other files used In deadstarting and terminating 
NOS/VE. The default is INTI. 


specifies the deadstart command deck to be used when 
deadstarting NOS/VE. The function served by the 
deadstart command deck is analogous to the function 
served by the CMRDECK of NOS. Currentiy supported 
values for c and thelr respective uses are: 


Arden Fills $3 S/N O02 open shop/hands—-on time 
Arden Filts $3 S/N 02 closed shop 

Arden Hitts $2 S/N 104 open shop/hands<-on time 
0 Sunnyvale $2 closed shop instailation 

0 Sunnyvele $2 closed shop continuation 


HOW, 


The default is set In the File CMDS1. Currently 
the default is 6. Warning: Specifying. C=6._on the 
Acden._Hills..83.will.destroy the NOS/VE_ permanent 
file bases 


specifies an alternate catalog to be searched for 
the varfous files used in deadstarting and 
terminating NOS/VE. The default is INT1. 


is used to indicate that the system core command 
processor should accept commands from the console. 
Specifying D=T itn the SETVE command allows the 
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operator to enter commands from the console after 
processing the deadstart command deck, If the 
operator wishes to initialize the system device 
and/or instell a new version of NOS/VE» D=T must be 
specified. The defauit is set in the file CMDS1. 
Currently the default is D=F. 


p specifies the password for the catalog indicated by 
the un parameter. If this parameter is omitted the 
password will be generated by appending an *X? to 
the UN parameter. 


ch specifies the octal channel to be used for NOS/VE 
disk I/0. The default is set in the file CMDS1. 
Currently the default is 2. 


yvsn specifies the vsn of a deadstart tape. If this 
parameter is used then NOS/VE will be deadstarted 
from the tape specified. If it is omitteds then 
NOS/VE will be deadstarted from the permanent File 
TPXXXKs 


502 SETVE USAGE 


Earlier versions of NOS/VE required that two SETVE commands 
be issued if the system was to be installed and subsequently 
recovered, The current system does not require this. The 
onty reason for Issuing two SETVE commands Is to provide a 
deadstart procedure that does not require/permit operator — 
Interventione 


It should be noted that once the SETVE command has been 
issueds it need not be issued again unlessees 


1) There is a need to change one or more of the parameters 
specified in SETVE. 


2) The command files NVEFFFTLs generated by the SETVE 
command is purged from the system. 


Two examolfes of SETVE usage and subsequent NOS/VE deadstart 
are given below. The first exampie shows a "hands on" user 
working with recovery. The second illustrates these concepts 
for a typical NOS/VE closed shop. This writer hopes that the 
reader will find both exampies useful and illuminating. 


I. A *hands on™ user 
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command file NVERSD is built and instalted tn NOS 
ing 


o SETVE(RSD sUN=2 SD so VSN=TAPEs B=DEV19C=69D=T) 


eral of the choices of parameters are worth 


* 


By specifying the VSN parameter the user has built 
a command file that wil! deadstart the system 
directiy from the tape produced by NVESYS. 


The user In this example has specified deadstart 
command deck 6 (C parameter) and has allowed the 
NOS/VE disk I/9 channel (ch parameter) to default 
to 2e Ore concludes that the user is running on 
the Arden tills $2. 


The user has specified D=T. This is important. 
The deadstart command which triggers installation 
of a recoverable system cannot be read from a 
deadstart command deck. It must be entered from 
the console at deadstart time. Specifying D=T 
allows the operator to enter commands from the 
console. 

VE is deadcstarted by typing 
VERSD. 

consolee 

user brings up the K display by typing 
sNVE. 
sentiys, the deadstart command deck is displayed 


e user js prompted “for inpute The deadstart 
d deck used in this examplte tooks tike this: 


S2CFISG 
EMPTY 
$7155_1 
$885 12 32 
user types 
DD VSNOO1. 
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Il. 


K.GD. 


The system accepts the commands and instalis and 
deadstarts NOS/VE. 


After the system comes downs via either controtiled 
termination or a crashs the system can be recovered (if 
necessary) and redeadstarted by typing 
NVERSD. 


When the deedstart command deck is disptayeds the 
user types 


K 260. 


This will cause NOS/VE to be deadstarted without 
initializing the system device. 


A typical "closed shop" 


Two command filess NVECLSH and NVEINSTs are created 
by typing 


XeSETVE(CLSHs UN=CLSH» B=DEV1»C=40sCH=1) 
MeoSETVECINS Ts UN=CLSH»s B= DEV1,C =10»sCH=15sD=T) 


One notes that 


1) Closed shop is deadstarted from a TPXXXK file in 
the CLSH catalog. 


2) Specifying D=Ts for NVEINSTs causes deadstart te 
pause for operator intervention. 


3) Using DCF deck 40 for continuation suppresses 
redundant (and possibly damaging) reexecution of 
the configuration prologe 


A normal deadstart is used when bringing up NOS/VE at 
the beginning of closed shop or following a system 
failure. The operators in this examples, types 


NVECLSH. 

NOS/VE will recover (if necessary) and deadstart. 
When recovery runsys the operator must respond to a 
request for input from the MANLC utility. See note 4 at 
the end of this section for more information. 
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If it is necessary to reinitialize the system devices 
or if the installation is upgrading to a new version of 
NOS/VEs the operetor keys 


NVEINST. 


This causes deadstart to pause and wait for operator 
input when deacstart commands are being processed. 
There are two cases requiring discussion here. The 
first is the case of upgrading to a new and compatible 
version of NOS/VE. The second case is used only when {it 
is necessary to reinitialize the system device. 


The first cese involves the installation of a new 
version of NOS/VE. In order to install a new version of 
the systems the old system must have been idied in an 
orderly waye A new system cannot be installed if» 
following a creshs the system being superceded was not 
recovered. Assuning everything in the otd system is 
tidys and the file systems are compatibles the operator 
keys 


KeUSECP EMPTY. 

KeSETSA INSTALL. JQBLTEMPLATES 1. 

K.GO. 

when the system displtays the deadstart command deck and 
prompts for input. The new system is installed» the 
file system is preserved, and deadstart proceeds. 


The second case amounts to an installation 
deadstart. This should be used only with full knowledge 
that any files which may have existed on mass storage 
one t to this deadstarts willbe blasted. Into. oblivion 
by_it. 


An installation deadstart will be required if 


1) This ts the Initial Installation of a recoverable 
version of NOS/VE. 


2) If the file systems of the system being instailed 
and the system being superceded are not 
compatible. 


3) If the file system has been damaged beyond the 
possibility of recovery. 


An installation deadstart is effected by typing 
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KeINITDD VSNOOL]. 
KeGDe 


when the deadstart command deck is displayed and the 
operator is prompted for input. 


NOTES: 


1. The CMDS1 fille used to deadstart NOS/VE must have 
the DEBUG2 fliag set to TRUE. When NOS/VE is 
deadstartec, the catalog specified by the UN 
parameter is first in the search order for CMDS1>» 
followed by the catatog specified by the B 
parameter. 


2e See Section 3.3 of the Integration Procedures 
Notebook for other information about thea CMD51 
file. 


3. If NGS/VE crashes and a dump is desired (in the 
context of our second example) 


i. Type du at the MDD console. The message 
"WRITING IMAGE FILE™ should appear 
immediately. The message "IT MAGE FILE 
COMPLETE” should appear a few moments 
latere 


iis Push the deadstart button. 
hii. Take the EDD dump. 
ive Do a tevel 3 NOS deadstart. 


Alternatively the operator can skip step i if 
she/he Is sure to redeadstart NOS/VE after step 
iv. In this event the system wil! detect that the 
image file was never createdy», will create ones and 
will recover from it. 


4. A recovery deadstart which is under the control! of 
a SETVE command in which D=T was specified will 
pause in the recovery system with the message 
"OPERATOR INTERVENTION BEFORE RECOVERY BEGINS", 
The system is executing the ftogical configuration 
utift— ity at this oofnt. In order to exit this 
utility and allow recovery to proceed the operator 
types K.QUIT {no perlod). For more details on the 
use of the LCU see Section 4.9 of this document 
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and the NOS/VE Instaltation Command Interface 
ERS. 
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6.0 SYSTEM_CORE. DEBUGGER 


The System Core debugger provides a set of capabilities 
intended to assist in debugging the operating systeme 
Services provided by the debugger are task oriented: selection 
of the tasks to be debugged must be made via debugger 
subcommands. No tasks will be under contro! of the debugger 
untess they are selected. The selection capability allows any 
number of tasks to be debugged simultaneously; from one task 
to all tasks in the system. Obviously a capability this 
powerful must be used with some caree The System Core 
debugger uses the debug hardware to provide these 
capabitities. 


61 SYSDEBUG 


The purpose of this command is to initiate execution of the 
system core debugger. This command can be issued from the 
deadstart command filte or as a command in any job. 
sysdebug 


This command has no parameters; all Information the 
debugger requires is provided via subcommands. 


The system core debugger can also be invoked from the MDD 
consolee The format of the command is? 


DO nesysdebug 

where n Is the job ordinal of the desired job. The debugger 
is brought up in the jcb monitor task of the Jobe. Atl system 
core debugger subcommands are availables but must be prefixed 
by the MDD command DO. 

The system core debugger can also be brought up (from the 
MDD console) by specifying a global task ide The format of 
the command is: 

DO netdebug ggaggga 
The value of n is ignoreds and the vatue ggggg9 specifies the 
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NOS/VE global task id (3 hex bytes) of the task to obring the 
debugger up ine If the task id is invalids then the command 
will be ignored. 


2 SUBCOMMAND PARAMETER CEFINITIONS 


{name> 332 ae character breakpoint name 
C<condition> 23= READ WRITES RNISBRANCHICALLIDIVFLT ARLOS! 
AROVFL SEXOVFELSEXUNFL? FPLOS: FPINDEFS INVBDP 


<base> %:= process virtual address 
<offset> ::2= Integer 

€length> ::= integer 

<frame> 3:3= 1.42100 

Ccount> :3= 14210000 

Cregidd> 22= XsAIP 


<regno> 222 0421530..0F(16) 
<value> 222 integer 

<timed 232 1.42(2**31)-1 
<vstring> :3= 'charstring! 
<datatype> ::2:= HEXSASC II ASC$ DEC 
Cchange_count> i22 1.2.8 
Cselector> 22 FULLTAUTOS SAVE 


663 SYSTEM_CORE DEBUGGER. SUBCOMMANDS 


Within the descricrtions which follows optional parameters 
are enclosed in brackets. Defauit vaiues for optional 
parameters are also defined. 


60301 SELECT 


The purpose of this subcommand is to select the tasks in 
which the system core debugger is to be active. When the 
debugger is first calleds it is not active in any task. To 
use the debugger therefores it is necessary to select the 
tasks in which it is to beactive. 


select <selection option> [<ring number> { <active job fist 
ordinal>] 


selection option: This parameter specifies one of a 
serles of selection options used to controf the 
tasks in which the debugger will be active and some 
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other debug options. The selections are remain in 
effect until they are explicitly changed with 
subsequent SELECT subcommands. Valid selection 
options are: 


<rightiteft> -—- This selects the screen for the debug 
dispiay. The display stays active when the screen 
is switched. 


<jobmonitorineojobmonitor> - This selects whether or 
not to debug job monitor tasks. 


<userinouser> - This selects whether or not to debug 
user tesks {(i.e. those that are not job 
monitors). 


<highring> ~- This specifies the highest ring in 
which debug traps will be recognized. Traps 
occurring in rings above this selection will be 
ignored, 


<jobinejob> ~- This enables or disables debugging for 
the jot at the specified active job tist 
ordinal. The system job has an active job list 
ordinal of zero. 


alijobsinojcbs> - This activates or deactivates 
debuggirg in all jobse 


The initial selections are: RIGHT» NOSTEP» 
NCOJOBMONITOR»s NOUSER»s HIGHRING=35 NOVJOBS. 


60302 BREAKPOINT !: B 


The purpose of this subcommand is to setect a program 
interrupt which Is to take place upon occurrence of a 
specified condition within a specified virtual address range. 


breakpoint <name> <condition> [<base>] [<offset>] C€<tength>] 

The <name> is any user supplied name for identifying the 
breakpoint. A maximum of thirty two breakpoints can be 
selected. When a trap occurss the <name> of the breakpoint 
which caused the trap is displayed, 


The base parameter is required when specifying a new 
breakpoint name; offset and length specifications are optional 
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in this case. When adding a new condition selection to an 
existing breakpoints bases offsets and length parameters may 
not be specified. 


Bases offsets and tength parameters define the desired 
virtual address range: <base> + <offset> yields a 
first=-byte-address; first-byte-address + <length> -1 yields a 
fast byte address. 


Default parameter values? 
Coffset>: 90 
<length>: 1 

60303 REMOVE BREAKPOINT $ RB 

The purpose of this subcommand Is to deselect a previously 
selected program inte 
remove _ breakpoint <name> [<conditiond ] 

If only the name parameter is specifleds al! conditions 
associated with the breakpoint are deselected and all evidence 
of the breakpoint is removed. If the condition parameter is 
specifieds oniy that cendition is deselected; howevers if the 


specified condition is the onty condition selecteds al! 
evidence of the named treakpoint Is removed. 


60304 LIST BREAKPOINT $ LB 

The purpose of this subcommand is to provide a list of 
currently selected breekp and associated conditions. 
fist_breakpoint [€<name>d] 

If the name parameter is specifieds information ts 
displayed for the named breakpoint only. If the name 


par ameter is not specifieds information is displayed for ali 
currently defined breakpoints. 
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60345 CHANGE_ BREAKPOINT 3 CB 


The purpose of this subcommand is to change the virtual 
address range of a previ specified breakpoint. 


change_breakpoint <name> <base> Cc<offset>] C<length>] 


Bases offsets and jength parameters define the desired 
virtual address range: <base> + <offseat> yields a 
first-byte—-address; first—-byte-address + <length> -1 yields a 
fast byte address. 


Default parameter values? 


<offset>: 9 
€length: 1 


60346 TRACE_BACK 3: TB 


The purpose of this subcommand Is to provide information 
relevant to stack frame associated with an interrupted 
procedure and its predecessor procedures. Validation of PVA‘ts 
is now performed. 


Information displayed for each setected stack frame 
consists of: 


~ Stack frame number 3 

- Current P-address of the associated procedure; 

- Virtuai address of the start of the stack frame; 
Virtual address of the stack frame save area. 


trace back (<frame>] [<count>] [CFULL! SHORT] 


The frame parameter specifies the number of the first stack 
frame for which information is to be displayed. Stack frame 
number one is associated with the interrupted procedures stack 
frame two is associated with the interrupted procedure's 
predecessors etce 


The modufte name fprovided on the traceback is usually 
correct but not guaranteed. 


The count parameter specifies the total number of § stack 
frames for which information is to be displayed. 
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Default parameter values: 
<frame>: 1 
<count>: 1 

60307 DISPLAY_STACK_FRAME $ DSF 

The purpose of this subcommand is to display selected 
information from a soecifi stack frame. 
display _stack frame [<frame>] [(<selector>] 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed. {Stack frame number 
one is associated with the Interrupted procedures, stack frame 
two is associated with the interrupted procedurets 


predecessors etc.) 


The selector parameter identifies a region of the specified 
stack frame: 


AUTO: Causes the automatic region of the stack frame to be 
displayed. 


SAVE: Causes the save erea of the stack frame to be 
displayed. 


FULL: Causes both the sutomatic and save areas of the stack 
frame to be displayed. 


Default parameter values: 

<frame>?: 1 

<selector>: FULL 
623.28 BDISPLAY_REGISTER : DR 

The purpose of this subcommand is to display the contents 

of a specified registe interrupted procedure. 
display register <regid> [<regno>] (<datatype>d] 
Default parameter values: 

<regno>: 0 
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60328 DISPLAY_REGISTER : DR 


<datatype>:? HEX 
60329 DISPLAY _MEMDRY : DM 


The purpose of this subcommand is to display the contents 
of a specified area of virtual memory. Validation of PVA'ts is 
now performed. 
display memory <base> [<length>] 

Default parameter values? 


€<length>: 8 
623210 CHANGE_MEMDRY $ CM 


The purpose of this subcommand is to set a specified value 
into a specified toca of virtual memory for a specified number 
of bytes. Validation cof PVA's is now performed. 
change _memory <base> <value> <change_count> 
Default parameter values: 


<change_count>: 1 
623el11 RUN 
The purpose of this subcommand is to invoke program 


execution after a selected p interrupt has occurred. 


fun 
603012 SUPER _CHANGE_MEMORY | SCM 


The purpose of this subcommand is the same as the change 
memory subcommands that iss to change the contents of virtual 
memor Ye It differs from change memorys howevers in that it 
will change the attributes of the segment to ailow memory to 
be writtens and then change the attributes back to their 
original values. 
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The command format is the same as the change memory 
subcommand. 


663213 FORMAT : FMT 


The purpose of this subcommand is te set the system core 
debugger into a mode where all subcommand output is sent to a 
permanent file. This is done by having the task running the 
debugger communicate with another task running in the system 
job. It ts this other task that actually creates and writes 
the permanent file. The entry point of this task is 
OSPSBROKEN_JOB_DUMP_TASK. It will normally be initiated by 
the 0S procedure. If it is not runnings a diagnostic will be 
issued. This task will create successive cycles of the 
permanent file "DUMP’ in the S3SYSTEM catalog. These files 
contain ASCII text data written in BAM variable records. The 
parameter to this command is a string which wlil be output as 
the First tine of the file. 


format string 
6.3214 UNFORMAT ¢$ UNFMT 


The purpose of this subcommand ts to leave the output mode 
established by the FORMAT command. Output will again be sent 
to the operator console. At this point the permanent file 
will be flushed to mass storage. 


unformat 
603015 DISPLAY_MONITOR_FALLT $ DISME 


The purpose of this subcommand is to display any monitor 
faults present in this task. See the section titied "NOS/VE 
Processing of Job Mode Software Errors! for more informatione 


Alf monitor fault buffers are displayed in the hope they 
will show some task history. If a given fault buffer is 
invalid the message “following fault is not present" is 
displayed. 


display monitor fault 
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623216 DISPLAY_XCB | DISXCB 


The purpose of this subcommand is to display all of the 
fields of the current task's (i.€e» the task running the 
debugger) execution cortrol bliock. 


603017 DISPLAY_TASK_LENVIRCNMENT 3 DISTE 


The purpose of this subcommand is to display the XCB of all 
tasks running within the current job (i.2.s the job with the 
task running the debugger). If the command is entered while 
the debugger is in Format modes then a full XC3 is displayed,» 
otherwise just the task names XCB address and giobal task id 
are displayed. 
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7.0 NOSAVE PROCESSING OF JOB MODE SDEIWARE_ ERRORS 


Vol INTRODUCTION 


Tasks running in jcb mode will occasionally cause an error 


which is detected either by the hardware or NOS/VE 


monitor. 


The action taken when an error ftike this occurs is controlled 
by various system attributes. The purpose of this section is 
to discuss the types of errors and the effect a given system 


attribute will have upon the handling of the error. 


7e2 TYPES_OF_ERBORS 


1) BROKEN TASK: A broken task is a task in which 


the trap 


mechanism is not able to function correctly. NGS/VE 
monitor will attempt to repair the trap mechanism and send 
a broken task fault to the task. The specific cases of a 


broken task are? 


system error job mode software has 
declared the task to be 
broken. (This is a special 
case of broken task.) 


monitor fault buffer full job mode errors are 
occuring but are not being 
processed by job mode. 


traps disabled a job mode error has 
occurred while traps were 
disabled. 

invatid Ad the task*s AO register was 
invalid. 

UCR/MCR traps disabled UCR/MCR error occurred with 


traps disabied. 


2) MCR FAULT: This error signifies that job mode caused a 


hardware detected MCR fauit. This may be 


caused by 
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software or hardware detected uncorrectabie error. 


3) UNKNOWN SYSTEM REQUEST: This error signifies that job mode 
issued a monitor request that Is elther Invalid or cannot 
be issued from the ring it was issued from. 


4) SEGMENT ACCESS FAULTS: These errors signify that job mode 
encountered or caused one of the following errors: 


- page fault for an address greater than EDI on a 
read—only file (segment) 


~ disk read error 


These errors either originate in NOS/VE monitor or cause 
the hardware to exchange to monitor. Depending on the values 
of certain system attributess monitor will halt or reflect the 
error back to job mode as a monitor default. 


It ts at this potnt that the system core debugger can be 
activated. (See the definition of SYSTEM_DEBUG_RING in the 
next section.) 


The normal jeb mode OS actions for these faults are: 


broken task exit 
MCR fauit cause condition 
invalid systewn request exit 
segment access cause condition 


7o3 SYSTEM ATTRIBUTES _EQR_ERROR. PROCESSING 


The following system attributes can be set or displayed by 
the SETSA and DISSA commands. 


7e3el HALTRING 


If a broken task or MCR fault occurs at or beilow the value 
of HALTRING (P register ring number)s NOS/VE monitor will hait 
the system. 3roken tesks occurring above HALTRING will cause 
a monitor fault to be sent back to job mode. 
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7.302 SYSTEM_ERROR_HANG_C CUNT 


This is the number of broken task errors allowed to occur 
In any given task before that task is considered a hung task. 


T2323 HALTLON_HUNG_TASK 


If this attribute Is trues then an occurence of a hung task 
will cause NOS/VE monitor to hait the system. If the 
attribute is false» the task will be sent a signal to ‘thang? 
itself, i2. to go into an infinite wait doing nothing. Jobs 
with hung tasks will have a *H In the status field on the 
operator CP display. 


A hung task will aiso occur if any error happens in job 
mode ring 1. 


70304 SYSTEM_DEBUG_LRING 


If an error (broken tasks MCR faults unknown system 
requests or segment access fault) occurs at or below the value 
of this attribute (P register ring number)» the system core 
debugger will be invoked within the task. At that point in 
time the task environment can be examined by using system core 
debugger commands. 


If the RUN command is issued to the debuggers, the system 
will take Its normal action for the specific fault. 


70325 DUMP_WHEN_DEBUG 


When the system core debugger is invoked by a fault at or 
below SYSTEM_LDEBUG_RISG and the DUMP_WHEN_DEBUG attribute is 
trues the debugger will automatically create a dump of the 
task (see system core debugger command FORMAT). When the dump 
is completes, normal fault action will take place. The 
following system core debugger commands are executed during an 
automatic dump: 


FORMAT automatic dump data 
TB 1 1000 
DISMF 
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DISXCB 

DM 00300000000 100C0{16) 
DM 00406000000 100C0{(16) 
DM 60500000000 100(0(16) 
DM 60600000000 1000(16) 
DM OOFCO000000 100C0(16) 
DM 01000000000 10000(16) 
DM 01100000000 100€0(16) 
DISTE 

UNFORMAT 
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6.0 STAND ALONE DEADSTART 


80 STAND ALONE _DEADSTART 


A 


standalone deadstart tape is a 9-tracks unlabeleds I 


formats 1600 BPI dersity tape (produced by the NVESYS 
procedure). To deadstart in standalone modes perform the 
following steps: 


1) 
2) 


3) 


4) 


5) 


6) 


7) 


8) 


Set the deadstart panel for standard disk deadstart. 


Perform an alternate deadstart to the NVE deadstart tape 
using CTI. The CTI parameters on the *P!' display should 
be set as follows 


L = 0 
C = <'C* parameter of the SETVE procedure> 
D = <'D* parameter of the SETVE procedure 


D= Y wher display is true 
D = N when no display> 
W14 = <'CH* parameter of the SETVE procedure> 


The tape should move and eventually the message 
"PROCEED" will appear on the tower left on the console, 


Enter CRseMxasBR=0COO0000 GCOCO00CD (Editor's note: 16 
zeros!) 


where Mx is M1 for $1 
M2 fer §2 
M3 fer $3 


This clears the wemory bounds register which is set by th 
deadstart. 


Enter DR»sP2 This disptays the CPU registers. The SIT 
should be changirg; if nots give up. 


At this point the system core is tloaded and can be 
patched. The commands to dispiay and change memory are 
documented In IPNDOC. 


To start the system enter 58 The CPU registers should 
spin; if they ever stop the CPU has halted. 


Enter DD to disptay the system dayfile on the right 
screens 
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B29 STAND ALONE DEADSTART 


9) 


10) 


11) 


Enter NVE deadstart commands when the system requests 
them. ('D = Y* must be specified on the 'P' display for 
this to happen.) 


Note: Standalone deadstart is always a 'quick! 
deadstarts 50 no recovery of permanent files is 
possible. QUICKDS® mode is set Internally and need not 
be specified. 


Enter DJ to display the system job dayfile when the 
system requests it. The "'DOJ' dispiay is on the Jeft 
screen. 


Now the system is operational and commands can be 
entered. 
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9-90 INTERACTIVE PROJECT DUMP. ANALYSTS _PROCEQURES 


The following procedures were developed by the interactive 
project to assist them In Interpreting dumps. They guarantee 
the procedures work if your user name is IFP3; otherwise caveat 
emptor. For more information about these proceduress contact 
Fred Bischkee 


The following dump enalysis procedures are available in the 
IFP catalog? 


9el 
EDDSIM 
This is a CCL procedure which brings an EDD dump tape on a 


specified 


VSN into the simulator. The procedure can be accessed from 
the IFP 


catalog as follows: 
getseddsim/unz=ifp 
beginsseddsimsysn ( vsn is the vsn of the EDD dump tape ) 
9.2 
ANALEXC 
This is a Simulater INCLUDE fille which does a preliminary 
analysis of 
the current simulator exchange package { when the system 


crashes in task 
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9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
922 


servicess this witt normally be JPS ). A qr exc=mon or ar 
exc=rma can be 


used to get Into arother exchange package before doing the 
include. 


The include file is ANALEXC/UN=IFP. It can be calied from 
the simulater 


as follows: 
'getsanalexc/un=ifp!' 3; include analexc 


(carriage return) a lone carriage return must be entered 
after an INCLUDE 
in order to start it up 


9.3 
SEGDUMP 


This is a CCL procedure which calis OSDIV to dump a 
specified segment to 
a list fille which can then be examined with an editor or 
printed. 
The procedure can te accessed from within the Simulator as 
fol lows? 
S‘getssegdump/un=ifp! 3; theginsssegdumpssegsiensfilesexcscpf? <* 


The segdump parameters are? 
seg ~ segment number in hex ( default is 1 ) 
fength - number of bytes to dump in hex ( default Is 10000 ) 
fist - name of the tist file ( default is LIST ) 
exc ~ reference exchange package ( default is JPS ) 
cpf - name of checkpoint file ( default is CPF ) 
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9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
9.3 


In most cases of task services debuggings onty the seg 
parameter is 


needed. 
904% 
ANALJOB 
This is a CCL procedure which uses DSDIVs XEDIT and the 


Stimulator to 


perform an analysis of ali tasks in a specified job. The 
procedure can 


be accessed from within the simulator as follows; 


§'getsanaljob/unz=ifp* 3; *beginssanaljobssegscpf! 


The anal job parameters are: 
seg ~- the monitor segment which contains the exchange 
packages of the job (14 is the system jobs 15 is job 1 etc. 
) ( default is 14 ) 
cpf - the name of the simulator fiie { default is CPF ) 
After the procedure has completeds a ltist of the RMA's of 
the 
job's exchange packages can be obtained by doing the 
Following: 
include tplist 


(carriage return) 


A traceback of ali tasks in the job can be obtained by 
doing the 
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9.90 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
9.4 


POPE EET ETT TTT TTT TTT EEE LELE TTT P TTT L LL 
following: 
include Hist 
(carriage return) 


inctude tbrun 


(carriage return) 
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1.0 Hardware Overview 


1.1 
 1e2 
1.3 


An introduction to CYBER 180 
€18sc Instant 


Model Indeperdent General Design Specification - 
ARH17006 


220 NOS Reference Manuals 


2el 
202 


203 


204% 
209 
226 
207 


228 


XEDIT V3.0 — 60455730 
TAF V1.0 User's Guide - 60455260 


NOS Version 2 Reference Set — Vol 3s 60459680 —- Vol 
4, 604596990 


NOS Systems Programmer’s Instant - 60459370 

NOS Version 2 Operator/Analyst Handbook — 60459310 
NOS Version 2 Diagnostic Index — 66459396 

NOS A170 ERS 

NOS A170 GID — ARH3060 


3.6 NOS/VE Reference Documents 


3el 


3e2 


Program Interface ERS -—- ARH36160 - obtained from 
Karen Rubey (482-3966) or via SES.~TGOLBOC 


Command Interface ERS =- ARH3609 - obtained from 
Karen Rubey (482-3966) or via SES.TOOLDOC 


NOS/VE Procedures and Conventions - SESDO10 - 
obtained by SES.TOOLDAC 


Listing of all NOS/VE Modules —- obtained by 
SESsDEVI.~LISTNVE. See Integration Procedures 
Notebook for details. 


NOS/VE Internal Interface Maintenance Procedures 
Memo available from $C. Wood. . 


Integration Procedures Notebook Obtained by: 
AcquiresIPNDCC/UN=DEV1. SESePRINTs IPNDOC. 
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4.0 Tools Reference Documents 
4.1 CYBIL Interactive Debugger — ARH3142 
4.2 SES User's Guide — ARH1833 
4.3 CYBIL Specification -— ARH2298 
40% C180 Assembler ERS - ARH1693 
4.5 Simulator ERS - ARH1729 
4.6 VEGEN ERS - ARH2591 
4.7 VELINK ERS =- ARH2816 
4.8 Simulated I/C ERS - ARH3125 
4.9 Object Code Utilities ERS - ARH2922 
4.10 CYBIL Implementation Dependent Handbook - ARH3078 


4-11 CYBER 180 INTERACTIVE DEBUG External Reference 
Specification and Users Guide - $4028 


4.12 CYBER 180 II Assembifer ERS - ARH3945 


4.13 E8S for Source Code Utility —- ARH3883 
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D1.0 KEYPOINIS 


Keypoints are used to give an execution tine trace of 
program flow by showing that a given function is being performed 
(that Is» that a given procedure Is being executed) . 

Keypoints may also be used to display request parameters, 
status and error conditions. 


Dlel LSSUING_KEYPOQINTIS_ERCM CyBii code 


The general form of the keypoint instruction is: 


#INLINE (*keypoint's keypoint class» osk$m * datas keypoint_id); 


D1e1l.1 KEYPOINT CLASSES 


A keypoint is idantified by both class,» and identifier. 

The following deck explains the partitioning of the keypoint 
classes. 
QSOKEYS 
COMMON 


CONST 
{ Keypoint Classes 3 
£ 


{ The 16 keypoint classes supported by the hardware are 
{ partitioned between the Systems Product Set and User as follows. 


osk$system_class = 0 {€ 0 «2 5 Fs 
osk3product_set_class = 6 { 6 e+ 19 }y» 
osk$user_class = 11 { 1] «2 14 JF» 
osktpmf_control = 153 
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Keypoint Multiplier: 


{ 
{ 
{ By conventions 

£ the 32 bit keypotnt code supported by the hardware 

{ is split into two fields. The right field contains a keypoint 

{ identifler which is used to identify a function within a 

{ keypoint class. For examples If a particular keypoint class 

{ represents exit from a procedures 

{ then the keypoint identifier might Identify exit from 

{ procedure A versus exit from procedure B. 

{ The teft fietd is used as a data parameter appropriate to the 
{ function identified by the keypoint identifier. In the 

{ procedure exit example sboveys 

{ the data parameter field might be used to indicate the 

{ status of the procedure call. 

{ The keypoiInt multipiier is used to partition the keypoint 

{ code into the two fieids. The data parameter should be 

{ multiplied by the keypoint muitiplier to prevent It from 

{ overlapping the keypoint identifier fieid. 


CONST 
osk3m = 40963 


DLlel.2 NOS/VE KEYPOINT CLASSES 


Five keypoint classes named ENTRY» EXITs UNUSUAL» DEBUG» 
and DATA are defineds taking five of the avallabie sixteen classes 
by the hardware. 


ENTRY = Every gated procedure plus al! major interna! procedures 
(those shared across functional areas) should contain a 
keypoint of this class. These keypoints should be placed 
as close as possible to the entry to the procedure. 


EXIT ~- Every gated procedure pius all major internal procedures 
{those shared accross functional areas) should contain a 
keypoint of this class. These keypoints should be placed 
as closed as possible to the exit to the procedure. 


UNUSUAL =— Every situation which is unexpected or quite unusual 
should contain a keypoint of this class. It Is intended 
that these keypoints would be enabled at all times. The 
frequency of encountering these keypoints SHOULD BE 
very low. The DATA keypoint class Is not aliowed in 
conjunction with a keypoint of class unusual. 
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DEBUG —- These keypoints are for providing additional trace 
information as an assist In debugging hardware or software 
problems. DEBUG class keypoints would be most useful in 
the more complex ereas of the system. 


DATA =~ This keypoint class can be used with ENTRY» EXITs and 
DEBUG keypoints for the gathering of extra data. Ai} DATA 
keypoints encountered are supplying additional data which 
will be associated with the fast ENTRY» EXITs or DEBUG 
keypoint. 

DATA keypoints should be used with care since the PMF 
hardware can only buffer up 16 keypoints,s keypoint cluster 
can cause lost keypoints. 


The following deck defines the NOS/VE OS class constants. 


OSDKEYC 
COMMON 
{Define KEYPOINT CLASS Codes. 


CONST 
oskidata = osk$system_class + 0» {£ GOS —- BATA keypoint} 
osk$unusual = osk$system class + ls {U 08 - Unusual keypoint.} 
osk3entry = osk$system_ciass + 2» ££ OS - Entry keypoint)} 
osk$exit = oskSsystem_class + 35 {X OS - Exit keypoint} 
oskidebug = osk3system class + 43 £0 QS - Debug keyroint.} 


{*callcsosdkeys 


N1.1-63 KEYPOINT DATA AND IDENTIFICATION 


Upon successful execution each keypoint instrucion will 
provide a total of 32 bits of information. Cur convention uses 
12 bits of this for keypoint identiflcation and the remaining 26 
bits as user supplied date. Try to use this 20 bits to supply 
meaningful Information (taskids segment numbers file Identifiers 
queue length» page numbers times etce). The keypoint 
Identification codes are cefined in the attached common decks. Qn 
DATA class keypoints the data belongs to the previous keypoint 
and the full 32 bits is available for additional user data. 
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D1.1.4 EXAMPLE ISSUING KEYPOINTS 


ENTRY keypoint with data: 


#INLINE( t*keypoint'»s oskS$entrys oskSm*taskid.indexys 
tmk$exit task); 


UNUSUAL keypoint with no cata: 
#INLINE (*@keypoint'ts osktunusuals O» mmktno memory); 
ENTRY keypoint with extra data: 


FINLINE ('keypoint’s oskSentry,s osk3m * segment_number » 
mmk3page_fault); 
HINLINE (*keypoint'ts osk#datas offset» 9); 


D1.1.5 KEYPOINT IDENTIFIERS 


Each area of the operating system has been given a range of 
identifiers to use for keypoints. The base for each area is 
defined on common deck OSOKEYD. Each area should 
have a deck xxDKEY (where xx is the product identifier) 
where the areas keypoint constants are defined(e.getmk$exit task). 
Please reference the section on keypoint description decks» for an 
exampie of one of these decks. 


OSDKEYD 
COMMON 
{This deck defines constants for use with KEYPOINTS. 


{Define base keypoint procedure identifiers for each area of the 
{os. 


CONST 
amk$base = 100s {100 =- 149} 
baksbase = 2005 {200 =- 249} 
cikdbase = 250, £250 - 299} 
cmk$Sbase = 300» {300 - 349} 
dbkSbase = 350» {£355 - 399} 
dmk$base = 4060,» {400 - 549} 
fmk$base = 559, {550 ~- 599} 
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ick3Sbase = 600» {600 - 649} 
ifkébase = 650», {650 ~- 699} 
iikSbase = 700» {700 - 749} 
ink$base = 750» {750 - 799} 
jmk3base = 800,» {800 - 849} 
Igk$base = 850, {850 - 899} 
1ikSbase = 900» {900 - 949} 
lok$base = 950» {950 - 999} 
luk$base = 1600, {1600 —- 1049} 


mikSbase = 1050, {165C - 1099} 
mmkSmonitor_ base = 11C0,» £1160 - 1149} 
mmk3 job base = 1150, {1150 - 1199} 
msk3base = 1200» {120C - 1249} 
mtkS3base = 1250, (125C - 1299} 


ock$base = 1300» {130C - 1349} 
of k$base = 1350s {135C€C ~- 1399} 
osk$base = 1400» {140C€ - 1449} 
pfkibase = 1500, (150C - 1549} 
pmk$base = 1600» {£16006 - 1699} 
thk$base = 1750, {1750 —- 1799} 
srk3base = 1800, {1806 ~- 1819} 


stk3base = 1850, (185 - 1899} 
tmk$monitor base = 19CO»s {1900 - 1949} 
tmk$S job base = 1950,» {1950 - 1999} 
jskimonitor base = 2000, {2000 - 2049} 
Jsk$ job base = 2050» {2050 - 2099} 
avk$base = 2100s {£210C - 2149} 
sfk$base = 2150, (215C€ - 2199} 
jlok$base = 2200, €220060 - 2249} 
rmk$3base = 2250s (225 - 2300} 
mtkS$assembly_language_base = 40003 {£4000 ~- 4095} 
£ OS assembly fanguage 4000 - 4095} 
{C*callcsosdkeyc 


D1.2 COLLECTING KEYPOINTS 


D1.2e1 JN THE STIMULATOR 


When executing on the simulator all keypoint Instructions cause 
an entry to be added to the local fite SESSMKF. 


Cycle Ss Sectoher 1982 


D1-6 
NOS/VE BACKGROUND DOCUMENTS 

| , | Boe tata 10/26/82 
D1.0 KEYPGINTS 
Dl.2.1 ON THE SIMULATOR 


D1l.2e2 ON THE HARDWARE 


Software keypoint collection is available for collecting system 
and job keypoints. System keypoints are those keypoints in the 
entire system and job keypolints are only those dealing with a 
particular job. Qnly one system keypoint collector 
can be active at one times but each Job may have an active 
job keypoint colfector. Software keypoints are collected on a 
file iocal to the job in which the keypoint collection task is 
running. After keypoint collection is terminated this file can 
saved on the 170 side and analyzed by the keypoint analyzer. 


Three commands are suprcrlied to utilize the keypoint feature: 
ACTK»s DEAKs and EMIK,. 


D1.2e2e01 ACTK command 


The ACTK command initiates keypoint recording and collecting. 
It has the form of: 


ACTKs modesenvironments ronitor masks job masks» 
start iclasssstop_clessykeypoint_ files 
collector_buffer_sizesycollector_deley 


mode or m = 'software't» "sty, parameter is 
thardware't, or th’ required 

environment or e@ = Pjobtytjt, parameter is 
tsystemt» or '"s!? required 

monitor mask or mm = a fist of Integers default is all 


ranging from 0 to 15 
example: mm=( 29699912) 


jJob.-mask or jm = a fist of Integers default is al 
 fanging from 0 to 15 
example: jm=(Cs3s5) 


Start class or start = an Integer in default is 15 
the range from 0 to 15 
This soecifies that keypolint collection 
should not start until a keypoint of this 
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class Is encourtered. 


stop_cilass or stop = an integer in defauit Is 15 
the range from 0 to 15 
This specifles that keypoint collection 
should stop when a keypoint of this 
class Is encountered. 


keypoint_file or kf = file name default is 
This specifies the file on which $LOCAL.KEYFILE 
keypoints are to be saved, 
This parameter is used 
only with software keypoints. 

collector _buffer_size or cbs = an integer default fs 102000 
In the range from 1000 to 100,000 
This parameter Is used only with 
software keypoints. 

collector delay or cd = an integer defauit is 50 
in the range from 10 to 100s0006 7 
The value specified is the delay 
period in milliseconds. This 
parameter is used onity with 
software keypoints. 


D1.2e02e2 DEAK command 


The DEAK command terminates keypoint collection. 
DEAK senvironment 
environment or e = *jobts! jt, default is job 


'system's, or ts! 


D1.2e62e3 EMIK command 


The EMIK command is used to issue keypoints. 
EMIKsclassscode 


class = an integer in the range default is 15 
from © to 15 


code = an integer in the range defauit is 0 
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from 0 to OFFFFFFFF(16) 


After keypoint collecticn is terminated the keypoint Files 
can be saved on the 170 by a REPLACE_FILE with B56 
conversions. For example. 

REPLACE_LFILEskeyfileskeyfiles b56 


Nn the 170 side this can be analyzed by using NYEKEY»s 
format = HDW. 


D1L.3 KEYPOINT ANALYZER_UTILITY 


D1L.3.1 NVEKEY 


The SESSMKF file produced on the simulators or the 
KEYFILE produced on the hardware can be reformatted Inte a 
readable listing by executing the following procedure. 


SES ~NVEKEY CKPF= ] CFORMAT= ] ([KD= 1] CAREA= ] 

NVEKEY creates a simulator generated keypoint trace file. 

The "kpf" parameter is the keypoint file used as input. 

The "kd" parameter is a file or tist of files which definets) 
the keypoint descriptions. 
m———PARAMETER----———DEF AU LT -----— ALLOWABLE VALUES$------ 


kp f "SESS MKF? file name 
"KEYFILE?® if format=HDW 

format 'SIm? simshdw 

kd TKEYDESC? file name(s) 

area EUSERE user name 


If run interactivelys wher the procedure terminates the 
reformatted listing is on local file KEYFILE. 


Cycle 9» October 1982 


D1-9 
NOS/VE BACKGROUND DOCUMENTS 


10/26/82 


D1.0 KEYPOINTS | 
D1.3.2 KEYPOINT DESCRIPTION FILE 


D1.302 KEYPOINT DESCRIPTION FILE 


The keypoint descriptions are used by the keypoint 
analyzer utility to direct the reformatting of the 
keypoint information. 


N1.3.2e1 keypoint decks 


Each area has a keypoint constant deck xxDKEY (where xx 
is the product id). The keypoint descriptions are now 
included in this deck immediately following the keypoint 
constants (simitiar to the message templates). 


Each description has the following format. 
Note: each element (If given) is positionally dependant. 


{CLASS CSUBLIDLFIELD] KEYPOINT_LABEL CDATALLABEL] CDATA_LFIELD] 


CLASS of keypoint - required 
E Entry 
X exit 
YU Unusual 
D Debug 


SUBLID_LFIELD - optional - (described later) 


KEYPOINT_LABEL - required - This ts a string that 
describes the purpose of the keaeypoint. 


DATA_LABEL ~— optionaj —- This Is a string of up to 8 
characters describing the data portion of the keypoint. 


DATA_LFIELD DESCRIPTOR — optional - This consists of data 
format and tength. 


data_format 
H Hex 
I Integer (decimal) 
A ASCIT 


Concatenated to this is the length of the data portion of 
the keypoints in decimal bits. 
For example: [20 
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D1.3.20121 EXAMPLE KEYPOINT DECK 


STDKEY 
COMMON 


{ PURPOSE: 
{ This deck contains all of the set manager keypoint constants. 


CONST 
stk$create_set = stkibhase + ly» 
{CE ‘'stp$create_set!? tring ' 4 } 


{X ‘'stp$create_set® "status * 120 } 


stk$purge_set = stk$base + 2s 
{LE *stp$purge_set! } 
{X %"stp$purge_set’ status ' 129 } 


stk$cant _dmustore_setlord = stk$base» 
{U ‘cant dmp$store_avt _setlordinal' tavtindx ' H20 } 


stk3pf_root_size = stkSbase + 53 
{D ‘pf_root size’ ‘frootsiz * H20 } 


2? PUSH (LIST t= OFF) ?? 
{*calic osdkeyd 
272? POP ?? 


M1.3-e2e1e2 SUBLIDLFIELD 


This optional fieid altcnws a means of subdividing a singie 
keypoint into several descriptors. The particular descriptor 
is chosen on the basis of a selectable number of bits of the 
data fleld. This fleid hes the following format: 


SUBLIDLLENGTH.SUB_LID_ MATCH 


SUBLID LENGTH - This specifies the number of bits (right most) 
of the data field to uses to determine which 
descriptor to choosee 


SUBLID MATCH - This specifies the integer identifier used to 
match the data porticnes 


Example: 
mak$page_fault = mmkdmonitor base + 6,» 
{CE 'page fault processor!’ } 
{E 4.1 "Page found in avail queue’® 'pfti * H16} 
{E 4.2 *Page found In avail modified queve * "pfti * H16} 
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If this keypoint was Issued and produced data of 2» the 
descriptor with the subLid match Field of 2 would be 
used ('page found in avall modified queue!’ ). 
These keypoints were issued with a subLid length = 4» 
thus the 4e¢x. For example: 
#INLINE (*keypoint!, osktentrys osk$m * 
(pfti * 16 {2 ** sub_Lid length} + 2{sub_id_match})> 
mmak$page_ fault); 


D1.3.2e2 generating the descriptor file 


The keypoint descripticns are kept on a file called KEYDESC 
on the Integration catatog.e. This file may be produced by: 


SES*GENCOMP M=OSMKEYS AB=((NOSVEPL»sOSLP Is INT2)) CF=KEYDESC 


The user may add keypoints to her xxDKEY deck ltocallys and 
the KEYDESC fille may be produced as aboves specifying the 
additional focal bases. The KEYDESC file may then be saved 
on her catalog. 


If new keypoint decks are added» *calic 's to these new decks 
chould be added to the deck GSMKEYSs and the appropriate 
base constants added to deck OSDKEYD. 


When transmitting changes to keypoint deckss be sure to inform 
integrations via the transittai forms to recreate the file 
KEYDESC. 


N1.3.22.3 osmkeys format 


This section will only be useful to those desiring to add 
additional keypoint classes» keypoint class base constants» 
or new keypoint description decks. 

The classess identiflerss and descriptions are each buffered 
by a commente For example» to add another keypoint class: 
{$$$ START KEYPOINT CLASSES 3%3$} 
CONST 

psk$entry = osk$product set _class + 13 {££ PS =— antry keypoint} 
{$$$ END KEYPOINT CLASSES $33 } 
note: The E follwoing the "{" will be used in the description. 
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This new section should be appended to the end of the KEYDESC 
file. Readers desiring mcre information should reference the 
attached BNF»s and the attached decks OSMKEYS. 


The following represents 2 sample of how to set up 
the description module. 
Note: Comment put around *#cail for sake of documentation only. 


DS MKEYS 

2? LEFT t= ls RIGHT s:= 11¢ ?? 
MODULE keypoint descripticn fille; 
{*callecsosdkeys 

{$$% START KEYPOINT CLASSES $34} 
{*callecsosdkeyc 

{$$$ END KEYPOINT CLASSES $33} 
($$$ START KEYPOINT IDENTIFIER BASES %3%} 
{*¥callcsosdkeyd 

{$$$ END KEYPOINT IDENTIFIER BASES 333} 
{$$S START KEYPOINT DESCRIPTIONS $33} 
{*callcpamdkey 

{*¥callcsbadkey 

C*callcscidkey 

{*callcscmdkey 

{*¥callcsdbdkey 

{*tcallcsdmdkey 

{*ecallcsfmdkey 

{*calicsicdkey 

{*tcalleosifdkey 

{*callcsiidkey 

{*calicsindkey 

{*calics jmdkey 

{*callcosigdkey 

{¥callcoslidkey 

{*callcslodkey 

{*callcstudkey 

{*catlcsmidkey 

{*callcsmmdmkey 

{*callcsmmdjkey 

{*callcemsdkey 

{*catlcsmtdkey 

{*callcsocdkey 

{*calicsofdkey 

{*calicsosdkey 

{*callcsofdkey 

{*calicspmdkey 

{*callosrhdkey 

{*callcssrdkey 

{*callcsstdkey 

{*catlcstmdmkey 
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{*calicstmdjkey 

{*¥calics jsdmkey 

{*callcos jsdjkey 

{*callcsavdkey 

{*callossfdkey 

{*calicrviodkey 

{*calleosrmdkey 

{$$ END KEYPOINT DESCRIPTIONS $43} 
MODEND keyooint _descripticn_fite; 


D1.4 REFQRMATTED_CILE_ DESCRIPTION 


The output from procedure NVEKEY is a flie called KEYFILE. 
This reformatted listing contains two sections. The first 
section is a listing of all the keypoints in the order they were 
issued. The second section is a summary of the number of times 
each keypoint occured. . 

Each line in the first section has the following format; 


RT TSL DATA DATA_LABEL S TN AREALID KP_LLABEL 


The RT field designates the value of the free running 
microsecond clock (time since deadstart) when the keypoint was 
executed. Qn the simulatcr the clock is incremented by 1 for 
each instruction executed. 


The TSL field designates the time (microseconds) since the 
fast keypoint instruction was executed. 


The DATA Field specifies the value of the data portion of the 
keypoint in the format described in the keypoint description 
file for this keypoint. 


The DATA_LABEL fleld Is the data fabel fieid from the 
keypoint description file for this keypoint. 
This Identifies the data teing displayed. 


The 8S field specifies the state of the machine when the 
keypoint was issued and is one of the following: 


M —- Monitor mode 
J - Job mode 


An * preceding the S fietd indicates that 
trap processing is actives that is the trap handier has 
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IN PE PE PO PE PO OE PE PE PEPE PE 18 20 78 PA OE ta 88 PO PO PO 08 PE PAPE OA OD FE POE OBOE PO PE PE PD 28 PE PE PE PO 28 PE FO F8 P86 P88 P08 F828 PAPE AE PA Pe ee 


been entereds but not exited. 


The TN fietd gives the global task Id of the task that 
was executing when the keypoint was issued. 
The system is task 1. 


The AREA_ID fleltd Is the area identifler for the area 
issuing the keypoint. 


The KP_LLABEL is the keypoint label fietd from the keypoint 
description file. This describes the keypoint. 


NOTE: For an undefined keypoints that iss one which has no 
descriptor entry», the area_id field contains the 
integer for the keypoint class» the class fieid 
on the output is specified as "UND"s and the KP_LABEL 
becomes the id -number of the keypoint. 


D1.5 BNE_KEYPOINT DESCRIPIION 


<analyzer_descriptor_input> i:= <keypoint_class_allocation_deck> 
{[ <definition_deck> ee. 1] 


<keypoint _class_allocation _deck> t:= <cybil code and/or comments> 
[ <class _base_definitions> eee Jj 
<cybilt code and/or comments> 


<class _base_definitions> 2:= <class_base_id> <spc> = <spe> <base> 


<class _base_Id> %:= osk3$system_class ! osk$product_set_class ! 
osk$user_class { osk$pmf_ control 


€spe> ss= € <space> eee | 
-€base> t3= <integer> 
<definition. deck> 22:= <cless definition _deck> } 
<base_ definition. deck> : 
<keypoint. definition. deck> 
<class_definition _deck> :3= {$$$ START KEYPOINT CLASSES $33} 
<cybil code and/or comments> 
{ <class _definitions> es. |] 
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<cybil code and/or comments> 
{$3% END KEYPOINT CLASSES $3%} 


Celass_definitions> 33:2 <keypoint_class> <spc> = <spe> 
. <class _base_Iid> <offset> 
{ <keypoint uclass_id> <cybil comment> 
<keypoint_class> ii= <identifier> 
Coffset> 3:32 + <sper> <integerd> <delimiter> 
<delimiter> %2= » 3 3 
<keypoint_class_id> %3:= <character> 
Cbase_definition _deck> 2:3: 
{3% START KEYPOINT IDENTIFIER BASES $343} 
<cybil code and/or comments> 
{ <range_base_ definitions> es | 
<cybil code and/or comments> 
{3$$ END KEYPOINT IDENTIFIER BASES $33} 


<range_base_definitions> %2= <keypoint_base> <delimiter> 
<base_range> 


<€keypoint base> 2%:= <spe> <hase_id> <spe> = <spe> <base> 
<base_id> 33:= <identifier> 
<base_range> 332 <spc> € <low _base> <sp> - <high _base> C } 7 
<low _base> 3:2 <integer> 
C<high _base> %3:= <integer> 
<keypoint definition _deck>d 33 
{$33 START KEYPOINT DESCRIPTIONS £33} 

<cybil code and/or comments> 

{[ <xxdkey_deck> ee. ] 

€cybil code and or comments> 


{$$$ END KEYPGINT DESCRIPTIONS $33} 


<xxdkey_deck> :s:= [€ <cybil code and/or comments> 1. 
{ <keypoint_Info> ees J] 


<keypoint_infod> 23:2 <keypoint_constant_line>D <delimiter> <eol> 


{ <keypoint descriptor > ess | 
{ <blank lines> ] 


Cycle 9s October 1982 


Di-16 
NOS/VE BACKGROUND DOCUMENTS 
10/26/82 


D1.0 KEYPOINTS 
D1.5 BNF KEYPOINT DESCRIPTION 


<keypoint _constant_line> t:2 <keypoint _constant> <spe> = <spce> 
<keypoint _base> <sped> ( <offset> ] <spe> 


<keypointlconstant> i3= <identifier>d 
<keypointibase> ::= <identifier> 


<keypoint _descriptord 23:= { <keypoint_descriptor_list> <sped> [— } ] 
<eoal> 


<keypoint descriptor _list> *3= <keypoint class_id> <spe> 
{ <special_case_code> ] <spe> 
{ <subLid _fietd> 1] <spe> <keypoint_label> 
<spe> €— <data_field> ] 


<special_case_code> :3= MiNi § i T 
{M = Mtr» N = Nos» 8S = task Switchs and T = Trap) 


Csub_id_field> :3:= <sub_Lid length> . <subLiduomatch> 
<sub_id_length> 3:= <flelc ulength> 

<fFleldilength> %23= 0..52 (in bits) 
Csub_id -match> i:= <small_integer> 

<smali_integer> 33:= 0..0 EFFFFFEEFFEFF(16) 

<keypoint_label>d i3= <label> 

<label> 33:2 * <character_string> ¢ 

<character_string> ?:= any visible characters except ! 
<data_field> ::= <data_label> <spcd [ <data_fieid descriptor> ] 
<data_label> ::= <label> 

<data_field descriptor> 3%= <data_format> ( <data_field_tength> ] 


<data_format> :3:2 A iH i} I 
(A = Afphanumerics H = Hexs I = Integer) 


<data_field_length> i3:= <fleld_ltength>d 

(NOTE: <subLidvlength> + <data field _fength> must be <= 52 bits ) 
(NOTE operating system <keypoint_class_id> = {DsEsU»X}) 

(NOTE: <keypoint lclass_id> for any keypoint used for 

additional information to previous keypoints 
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must be a space) 


(NOTE: a <definition_deck> remains tn effect until 
superceeded by a deck which redefines the 
area to which it pertains) 
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